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I.  INTRODUCTION 


A.  OBJECTIVE 

The  Object  Oriented  Method  for  Interoperability  (OOMI)  [Young02]  defines  an 
object-oriented  method  and  a  suite  of  tools  to  resolve  representational  differences  between 
systems.  The  OOMI  method  and  tool  suite  will  reduce  the  labor-intensity  and  complexity  of 
the  integration  of  disparate  systems  into  a  cooperative  system  of  systems  (federation  of 
systems)  and  their  subsequent  deployment. 

The  objective  of  this  thesis  is  to  develop  a  prototype  implementation  of  the  translation 
generator  module  for  the  OOMI  IDE  and  a  prototype  translator  that  will  make  use  of  the 
translations  created  by  the  IDE. 

The  OOMI  and  the  OOMI  IDE  will  be  introduced  in  detail  under  section  II. B. 

B.  THE  INTEROPERABILITY  PROBLEMS 

Few  systems  operate  in  a  totally  isolated  environment  where  they  are  fully  self- 
contained,  with  no  requirement  to  interoperate  with  other  systems.  Many  systems  interoperate 
with  each  other  through  the  exchange  of  information  and  the  joint  execution  of  tasks. 

Legacy  systems  are  often  enhanced  with  capabilities  to  export  their  data  or  to  make 
their  operations  available  to  other  systems  in  order  to  achieve  new  objectives  or  enhance 
performance.  New  systems  that  consume  information  from  others  and  produce  information 
for  external  consumption  are  being  developed  and  coming  on-line  everyday.  Similarly,  both 
legacy  and  new  systems  typically  have  requirements  to  interoperate  with  other  systems 
through  the  joint  execution  of  tasks  in  order  to  achieve  their  objectives. 

Such  trends  in  system  integration  led  to  the  new  concept  in  information  technology: 
development  of  a  “System  of  Systems  (SoS)”,  also  commonly  known  as  a  “Federation  of 
systems”.  A  system  of  systems  is  a  composite  system  made  up  of  independently  developed 
systems.  We  should  also  take  note  that  almost  all  non-trivial  software  systems  are  composed 
of  smaller  subsystems  or  components.  In  a  way,  all  systems  can  be  considered  as  a  system  of 
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systems.  In  order  to  interoperate,  the  component  systems  in  the  system  of  systems  exchange 
information  and  operations  used  to  model  the  real-world  objects  (also  known  as  real-world 
entities  from  the  component  system’s  problem  domain).  This  implies  that  each  component 
system  needs  to  understand  the  models  used  by  other  systems  to  represent  the  real-world 
entities  involved  in  system  interoperation.  This  leads  to  the  0(n)  translations  problem. 

The  0(n)  translations  problem  occurs  when  legacy  systems  are  being  integrated  due 
to  the  potentially  different  models  used  by  the  independently  developed  systems.  This  is  also 
a  problem  for  new  systems  that  are  being  developed,  if  they  are  required  to  interoperate  with 
other  autonomously  developed  systems  during  their  lifetimes. 

1.  The  0(n2)  Translations  Problem 

Systems  of  systems  (SoS)  are  rapidly  being  developed  to  meet  the  stringent  demands 
of  today’s  applications.  A  system  of  systems  may  be  composed  not  only  of  legacy  systems, 
but  also  newly  developed  systems.  As  new  systems  are  being  developed,  each  will  have  to 
consume  data  from  other  systems  in  diverse  formats. 

A  producer  typically  exports  data  to  more  than  one  consumer.  The  consumers  may  or 
may  not  agree  on  a  common  data  format  with  the  producer.  Similarly,  a  consumer  may  need 
to  accept  data  from  multiple  producers;  each  producer  may  export  its  data  in  a  unique  format. 
As  a  result,  each  producer  has  to  export  data  in  multiple  formats,  while  each  consumer  has  to 
be  able  to  process  data  in  different  formats  for  each  producer  it  communicates  with.  Each 
system  has  to  translate  the  incoming  or  outgoing  data  as  required,  resulting  in  a  worse  case 
scenario  of  having  to  have  n(n-l)  translations  in  a  SoS  comprising  n  systems.  That  is,  a  worse 
case  complexity  of  0(n2)  is  experienced  in  terms  of  the  number  of  translations  for  the  systems 
within  a  SoS,  as  shown  in  Figure  1-1. 
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Figure  1-1 .  The  0(n“)  translations  problem. 


2.  Computer-Aid  In  Managing  Common  Representations 

The  most  obvious  solution  to  the  0(n  )  translations  problem  would  be  for  all  systems 
that  exchange  information  about  real-world  entities  to  agree  on  a  common  model  for  the 
shared  infonnation.  Information  can  then  be  exchanged  using  the  common  model,  with  each 
system  only  concerned  with  the  translation  between  the  common  model  and  its  own  internal 
model,  as  illustrated  in  Figure  1-2. 


As  the  component  systems  evolve  and  as  new  systems  join  the  federation,  the  common 
model  will  evolve.  As  growth  in  the  complexity  of  the  common  representations  is  inevitable, 
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a  tool  to  aid  in  the  construction,  organization  and  subsequent  maintenance  of  the  set  of 
common  representations  is  needed. 

The  OOMI  and  its  set  of  tools,  described  in  more  detail  in  chapter  II,  are  designed  to 
address  the  0(n)  translations  problem,  to  provide  an  object-oriented  method  for  constructing 
a  set  of  common  representations  and  to  provide  computer-aid  in  its  construction,  organization 
and  subsequent  maintenance. 
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II.  BACKGROUND 


A.  HETEROGENEITY 

1.  Eight  Classes  of  Heterogeneity 

Interoperating  systems  share  information  about  real  world  objects,  but  such 
information  is  typically  represented  differently.  Gio  Wiederhold,  a  pioneer  in  early 
multidatabase  efforts,  defined  seven  classes  of  heterogeneity.  Based  on  Wiederhold’s  work, 
Young  added  heterogeneity  of  structure  and  renamed  heterogeneity  of  representation  to 
heterogeneity  of  denotation,  resulting  in  the  following  classification  of  modeling  differences 
between  different  systems  [Young02]: 

1.  Heterogeneity  of  Hardware  and  Operating  Systems 

2.  Heterogeneity  of  Organizational  Models 

3.  Heterogeneity  of  Structure 

4.  Heterogeneity  of  Denotation 

5.  Heterogeneity  of  Meaning 

6.  Heterogeneity  of  Scope 

7.  Heterogeneity  of  Level  of  Abstraction 

8.  Heterogeneity  of  Temporal  Validity 

A  more  detailed  discussion,  summarized  from  [Young02],  of  the  eight  classes  of 
heterogeneity  follows: 

a.  Heterogeneity  of  Hardware  and  Operating  Systems 
Hardware  platform  and  operating  system  differences  can  result  in  differences 
in  the  physical  representation  of  information.  For  example,  in  the  representation  of  integers, 
differences  in  word  order  such  as  Little  Endian  versus  Big  Endian  are  common  between 
systems.  Such  low-level  differences  are  generally  encapsulated  from  the  application 
developers  through  the  use  of  distributed  computing  frameworks  such  as  the  Common  Object 
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Request  Broker  Architecture  (CORBA),  Microsoft’s  .Net,  Distributed  Component  Object 
Model  (DCOM)  or  Java’s  Remote  Method  Invocation  (RMI). 

b.  Heterogeneity  of  Organizational  Models 

Heterogeneity  of  organizational  models  refers  to  differences  in  the  conceptual 
models  used  by  autonomously  developed  systems.  In  the  context  of  interoperability, 
heterogeneity  of  organizational  models  can  refer  to  differences  in  analysis  and  design 
principles  employed,  such  as  use  of  an  Object-Oriented  Analysis  and  Design  (OOAD) 
approach  versus  a  structured  analysis  approach. 

c.  Heterogeneity  of  Structure 

Variations  in  the  structure  of  how  information  is  arranged  can  occur  among 
systems  using  the  same  organizational  model.  These  variations  can  include  differences  in 
structural  composition,  possible  schema  mismatches,  and  variations  due  to  the  presence  of 
implied  information.  For  example,  a  customer  may  be  modeled  as  an  object  in  one  system, 
but  in  another  system,  it  may  be  modeled  as  a  string  containing  the  unique  identification  of  the 
customer. 

d.  Heterogeneity  of  Denotation 

Heterogeneity  of  denotation  includes: 

■  domain  mismatch  problems  -  occur  when  the  same  concept  is 
characterized  differently,  for  example,  geographic  position  can  be 
measured  in  longitude/latitude  in  one  system,  and  be  measured  in  Military 
Grid  Reference  System  (MGRS)  in  another  system 

■  differences  in  units  of  measurements  -  for  example,  one  system  may  use 
the  imperial  units  of  measurement,  while  other  systems  may  be  using  the 
metric  system,  such  differences  may  occur  even  within  the  same  system, 
between  different  autonomously  developed  modules 

■  differences  in  precision  -  for  example,  one  system  may  use  a  single 
precision  floating  point  representation,  while  another  system  may  use  a 
double  precision  floating  point  representation 
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■  disparate  data  types  -  for  example,  date  may  be  represented  as  a  record 
containing  the  integer  fields  year,  month  and  day,  or  as  a  character  string 
like  “1  January  1970” 

■  different  field  lengths  -  for  example,  different  field  lengths  may  be 
allocated  for  the  name  of  a  person  on  different  systems 

■  different  integrity  constraints  on  the  same  value  -  for  example,  one  system 
might  allow  a  value  for  missile  effectiveness  in  the  range  of  one  to  twenty 
nautical  miles  whereas  a  different  system  might  allow  effective  range 
values  up  to  thirty  nautical  miles 

e.  Heterogeneity  of  Meaning 

The  use  of  synonyms,  homonyms  and  abbreviations  contribute  to  this  kind  of 
difference.  For  example,  synonyms  like  location  and  position  can  both  be  used  to  describe 
geographic  coordinates.  The  same  word  can  also  have  different  meanings  (homonyms),  for 
instance,  the  word  tank  can  describe  both  a  tracked  combat  vehicle  and  a  water  container. 
The  use  of  abbreviations  is  a  special  case  of  the  use  of  synonyms.  Different  abbreviations  can 
represent  the  same  entity,  such  as  the  use  of  POSIT  and  POS  to  refer  to  position. 

f  Heterogeneity  of  Scope 

Heterogeneity  of  scope  results  from  differences  in  the  information  used  to 
model  a  real  world  entity.  Different  applications  will  capture  different  attributes  of  a  real 
world  entity,  based  on  their  specific  needs.  For  example,  a  logistics  management  system 
might  include  attributes  fuelCapacity  and  ammunitionStatus  for  a  main  battle  tank,  whereas  a 
command  and  control  system  would  include  attributes  weaponRange  and  defensiveArmor  in 
its  tank  model. 

g.  Heterogeneity  of  Level  of  Abstraction 

Different  systems  use  different  levels  of  abstraction  when  modeling  a  real 
world  entity.  For  example,  a  division  level  command  and  control  system  models  an  infantry 
platoon  as  a  single  entity,  while  a  battalion  level  command  and  control  system  may  model  a 
platoon  as  a  collection  of  sections  or  groups. 

h.  Heterogeneity  of  Temporal  Validity 

Modeling  differences  may  result  from  differences  in  when  the  model  observes 
or  records  the  state  of  a  real-world  entity  and  differences  in  the  length  of  time  a  piece  of  data 
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remains  valid.  For  example,  a  battalion  level  command  and  control  system  may  require  a 
second-by-second  update  on  the  positions  of  all  its  platoons,  a  division  level  command  and 
control  system  only  needs  a  minute-by-minute  update. 

2.  Differences  in  View  and  Representation 

The  eight  classes  of  heterogeneity  are  further  categorized  by  Young  as  differences  in 
view  and  differences  in  representation. 

Differences  in  view.  Different  systems  capture  different  characteristics  of  a  real  world 
object  ( heterogeneities  of  scope,  level  of  abstraction  and  temporal  validity  [Wie93,Young02]). 
For  example,  in  Figure  II- 1,  three  different  views  of  a  surface-to-surface  missile  system  are 
provided  by  the  systems  modeling  that  real-world  entity.  In  the  first  view,  systems  A  and  D 
capture  information  about  the  entity’s  type,  position  and  time,  whereas  system  B  provides  a 
model  of  its  position,  time  and  range.  Finally,  system  C  provides  a  third  view  of  the  surface- 
to-surface  missile  capturing  the  entity’s  type,  position,  time  and  range. 

Differences  in  representation :  In  addition,  the  same  characteristics  may  be 
represented  differently  ( heterogeneities  of  organizational  models,  structure  and  denotation 
[Wie93,  Young02]).  For  instance,  as  shown  in  Figure  II- 1,  a  specific  location  on  the  globe 
may  be  represented  by  latitude  and  longitude  (system  A  position )  on  one  system,  or  be 
represented  by  the  military  grid  reference  system  (system  B  location )  on  another. 
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Figure  II- 1.  Differing  Real-World  Views  of  the  same  object  [from  YoungOl]. 


B.  OBJECT-ORIENTED  METHOD  FOR  INTEROPERABILITY 
(OOMI) 

1.  Introduction 

The  Object-Oriented  Method  for  Interoperability  (OOMI)  [Young02]  proposed  by 
Young  is  a  methodology  that  addresses  the  0(n  )  translations  problem  in  interoperability  and 
is  a  systematic  method  in  which  information  shared  between  interoperating  systems  can  be 
modeled  in  a  standard,  object-oriented  manner. 

The  OOMI  consists  of  three  major  components  as  shown  in  Figure  II-2: 

■  The  Federation  Interoperability  Object  Model  (FIOM)  -  the  standard  model 
shared  between  systems  in  a  federation. 

■  The  OOMI  Integrated  Development  Environment  (OOMI  IDE)  -  a  graphical 
user-interface  based  development  environment  used  to  maintain  the  FIOM. 


9 


■  The  OOMI  Translator  -  the  run-time  component  that  will  resolve  the 
differences  in  information  models  of  component  systems  in  a  federation. 


Figure  II-2.  Major  components  of  OOMI. 


2.  The  FIOM 

The  OOMI  proposes  that  inter-operating  component  systems  be  organized  into  a 
federation  with  a  common  Federation  Interoperability  Object  Model  (FIOM)  containing 
information  on  the  Real-World  Entities  (RWEs)  shared  among  federation  components.  The 
FIOM  (Figure  II-3)  is  composed  of  Federation  Entities  (FEs),  each  representing  a  real  world 
entity.  The  FE  comprises  a  hierarchical  tree  of  Federation  Entity  Views  (FEVs)  forming  an 
inheritance  hierarchy  of  FEVs  within  the  FE.  Each  FEV  represents  the  view  that  a  component 
system  or  group  of  component  systems  has  of  the  RWE. 
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FIOM 


Figure  II-3.  The  FIOM. 


Each  FEV  contains  exactly  one  Federation  Class  Representation  (FCR)  which 
represents  the  standard  representation  of  the  view.  The  FCR  serves  as  the  intermediate 
representation  for  translation  between  the  source  and  destination  systems.  An  FEV  also 
contains  one  or  more  Component  Class  Representations  (CCRs).  The  CCR  is  a  direct 
mapping  of  a  component  system’s  unique  representation  of  the  RWE.  Translations  between 
the  FCR  and  CCR  are  defined  within  the  FIOM.  Figure  II-4  depicts  an  FEV’s  components. 
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Conceptually,  a  FCR  or  CCR  contains  a  set  of  properties  (attributes  and  operations) 
that  represents  the  state  and  behavior  of  the  RWE,  as  depicted  in  Figure  II-5. 


Figure  II-5.  Conceptual  views  of  FCR  and  CCR. 

Since  an  FEV  is  represented  by  exactly  one  FCR,  an  FEV  can  be  visualized  as  a  class 
with  a  set  of  attributes  and  operations,  as  illustrated  in  Figure  II-6. 


Figure  II-6  A  simplified  view  of  an  FEV. 

Using  the  FCRs  as  the  standard  representation  for  RWEs,  each  component  system  only 
has  to  provide  the  logic  to  translate  between  its  unique  representation  of  the  RWE  and  that  of 
the  corresponding  FEV. 

One  important  property  that  must  be  maintained  within  an  FE  is  the  following: 

For  any  federation  entity,  E,  and  X,  Y,  where  X  and  Y  are  different  views 
(FEV)  of  E;  p(X)  and  p(Y)  are  the  set  of  properties  of  X  and  Y  respectively.  If  there 
exists  an  attribute  named  a,  such  that  a  e  p(X)  a  a  e  p(Y),  then  a  must  have  the 
same  real  world  meaning  within  the  context  of  E  in  both  X  and  Y,  and  the  value  of  a 
can  be  directly  copied  between  a  of  X  and  a  of  Y. 

This  property  is  exploited  in  the  OOMI  translator  to  automatically  detennine  candidate 
destination  FCRs  for  a  source  FCR. 
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As  shown  in  Figure  II-7,  the  number  of  unique  translations  required  within  a 

2 

federation  comprising  n  systems  using  the  OOMI  is  2n  or  O(n),  instead  of  0(n  ),  as  in  the  case 
without  a  FIOM. 


vvitn  i-ium  Component  Systems  only,  no  FIOM 

4  nodes  and  8  possible  translations  4  nodes  and  12  possible  translations 

Figure  II-7.  Translations  required  with  and  without  FIOM. 


The  FIOM  also  provides  benefits  in  terms  of  the  visibility  and  understandability  of  the 
shared  information  and  a  foundation  for  easy  extension  as  new  systems  are  added  to  an 
existing  federation  [YoungOl]. 

3.  The  OOMI  IDE 

The  OOMI  IDE  is  a  graphical  user  interface  (GUI)  based  tool  that  is  used  by  the 
Interoperability  Engineer  (IE)  to  construct  and  maintain  FIOMs.  The  main  functions  of  the 
OOMI  IDE  allows  the  IE  to  perform  the  following: 

■  Maintain  multiple  FIOMs 

■  Specify  different  views  of  a  real-world  entity  resulting  from  the  different 
perspectives  each  component  system  has  of  that  entity 

■  Construct  and  maintain  an  inheritance  hierarchy  relating  the  different  views  of  a 
real-world  entity 

■  Define  standard  federation  representations  of  the  real-world  entity  views  identified 
and  establish  the  relationship  between  the  standard  view  representation  (FEV  and 
its  defining  FOR)  and  the  various  component  system  view  representations  (CCR) 
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■  Define  the  transformations  (also  known  as  translations)  required  to  translate 
between  component  system  and  standard  representations  of  a  view 

4.  The  OOMI  Translator 

The  OOMI  Translator  uses  the  FIOM,  which  the  IE  constructed  using  the  OOMI  IDE, 
to  reconcile  differences  in  real-world  entity  view  and  representation  among  component 
systems  of  a  federation  at  run-time.  The  design  and  implementation  of  the  prototype 
translator  is  presented  in  more  detail  in  chapter  V. 

C.  OTHER  METHODS  FOR  INTEROPERABILITY 

Interoperability  between  systems  takes  two  basic  forms: 

1 .  Exchange  of  information 

2.  Remote  procedure/method/service  invocations 

In  this  section,  we  will  briefly  look  at  the  tools  currently  available  to  achieve 
interoperability. 

1.  Distributed  Computing  Frameworks 

Distributed  computing  frameworks  encapsulate  the  ugly  details  of  lower  level 
networking  application  programming  interfaces  (API)  like  the  popular  Berkeley  Sockets 
(BSD)  API.  Currently,  there  are  two  basic  types  of  distributed  computing  framework:  non¬ 
object  based  and  object  based. 

The  Remote  Procedure  Call  (RPC)  protocol  is  a  non-object-based  framework.  The 
RPC  protocol  provides  encapsulation  over  the  differences  in  representation  of  primitive  data 
types  (byte-order,  number  of  bits,  etc.)  due  to  the  underlying  hardware,  operating  systems  and 
programming  languages. 

Object-based  frameworks  provide  a  higher  level  of  abstraction  than  RPC  by 
introducing  the  concept  of  remote  objects  and  remote  invocations  of  these  objects’  methods. 
These  frameworks  extend  the  object-oriented  programming  paradigm  over  the  network, 
although  in  general,  inheritance  is  not  support  in  the  object-based  frameworks.  Most 
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implementations  of  these  frameworks  also  feature  a  Broker  architecture  for  service  discovery, 
location  transparency  and  load  balancing.  Examples  of  such  frameworks  are  the  Common 
Object  Request  Broker  Architecture  (CORBA),  Microsoft’s  .Net,  Distributed  Component 
Object  Model  (DCOM)  or  Java  Remote  Method  Invocation  (RMI). 

Distributed  computing  frameworks  do  not  address  the  0(n  )  translations  problem,  as 
they  do  not  define  a  methodology  for  systematically  developing  a  common  representation  for 
information  between  interoperating  systems.  But  they  are  useful  in  serving  as  the  underlying 
vehicle  for  network  communications. 

2.  BizTalk 

BizTalk  is  a  Microsoft  initiative  to  address  document  interchange  between  businesses. 
It  is  a  specification  for  business-to-business  exchanges  using  XML-based  SOAP  1.1 
messages.  BizTalk  is  an  “open”  standard,  supported  by  Boeing,  Compaq,  SAP,  United  Parcel 
Service  (UPS)  and  other  companies. 

BizTalk  comprises  three  major  components: 

■  BizTalk  Framework  Independent  Document  Specification 

■  BizTalk.org 

■  BizTalk  Framework  Compliant  (BFC)  Server 

Conceptually,  the  BizTalk  framework  is  similar  to  the  OOMI  in  the  sense  that  a 
standard  set  of  XMF  document  schemas  will  be  defined  and  published  for  use.  The  BizTalk 
Web  site  will  house  schemas  (or  "contracts")  that  developers  using  XMF  and  BizTalk  have 
proven  effective  in  specific,  vertical  implementations  with  specific  software  packages.  To  be 
posted  publicly,  the  schemas  must  pass  an  automated  standard  conformance  script  (promised 
to  be  freely  viewable).  These  schemas  dictate  "what  I  send  you,  what  you  send  me  back,  what 
you  promise,  what  you  respond,"  and  even  what  specific  documents  are  sent  back  and  forth 
[Hadfield], 

The  BizTalk  framework  requires  that  the  participating  systems  conform  to  the 
published  standard  schemas.  It  does  not  provide  tools  to  resolve  the  representational 
differences  between  the  standard  schemas  and  legacy  systems’  native  data  format.  Such  tools 
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are  to  be  provided  by  third  party  vendors,  for  example,  the  Microsoft  BizTalk  Server  2002. 
These  third  party  tools  allows  a  2-step  transfonnation  process  that  resolves  the  0(n2) 
translations  problem.  But  these  tools  do  not  provide  models  similar  to  the  OOMI’s  FIOM  to 
capture  differences  in  views  of  real  world  entities  in  a  way  that  allows  easy  extension. 

3.  Generic  Interoperability  Framework  (GINF) 

“The  goal  of  the  Generic  Interoperability  Framework  (GINF)  is  to  facilitate 
interoperability  between  heterogeneous  systems.  GINF  is  a  set  of  principles, 
which  describe  an  application-neutral  way  of  interaction  between  software 
components.  The  key  principles  include: 

—  Generic  representation:  protocol  information,  languages,  data  and 
interface  descriptions  are  represented  in  a  uniform  manner  using 
directed-labeled  graphs. 

—  The  ability  to  dynamically  fetch  a  machine-readable  description  for 
every  piece  of  information  exchanged  between  components.” 

(from  [Melnik+]) 

The  Generic  Interoperability  Framework  (GINF)  proposes  that  messages  exchanged 
between  systems  be  based  on  the  Resource  Description  Framework  (RDF)  models.  These 
models  are  directed  labeled  graphs  where  an  edge  of  the  graph  represents  a  predicate  that 
holds  between  a  subject  node  and  an  object  node.  Nodes  can  be  either  a  resource  node  or  a 
literal  node.  Resources  are  entities  that  can  be  specified  using  a  Unifonn  Resource  Identifier 
(URI).  String  or  binary  data  are  described  using  literals.  On  receiving  a  message  (a  graph), 
the  system  can  look  up  schema  infonnation  that  describes  unknown  elements  used  in  the 
graph  using  the  URIs  specified.  [Melnik+99] 

The  key  here  is  that  a  component  system  is  able  to  dynamically  discover  the  meanings 
of  the  elements  in  the  document  received  using  their  associated  URIs.  It  does  not  address  the 
O(n  )  translations  problem,  since,  for  a  system  to  talk  to  N  other  systems,  it  will  still  have  to 
accept  their  documents,  each  possibly  represented  in  N  ways,  and  be  able  to  translate  such 
documents  into  a  fonn  suitable  for  its  own  processing.  However,  such  translation  is 
simplified  due  to  the  semi-parsed  format  of  the  directed  labeled  graph  model  of  the  RDF 
specification. 
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D.  OVERVIEW  OF  XML  AND  JAVA-XML  DATA-BINDING 


The  initial  prototype  of  the  OOMI  toolset  is  implemented  in  Java.  The  prototype 
requires  all  component  systems  to  export  or  import  their  information  model  as  well-formed 
XML  documents.  These  XML  documents  are  transformed  into  Java  objects  using  Java-XML 
Data-Binding. 

1.  XML 

The  Extensible  Markup  Language  (XML),  which  is  a  meta-markup  language  that 
became  a  World  Wide  Web  Consortium  (W3C)  recommendation  in  January  of  1999,  is  the 
language  of  choice  for  structured  documents  and  data  on  the  Internet.  It  is  platform- 
independent,  non-proprietary,  customizable,  self-describing  and  human  readable  (human 
readable,  as  opposed  to  proprietary  binary  formats).  These  properties  make  it  desirable  for 
data  representation  in  almost  any  system.  However,  it  should  also  be  noted  that  XML  might 
not  be  suitable  in  environments  where  processing  power,  memory  or  bandwidth  is  limited,  as 
in  embedded  systems  or  low-end  mobile  devices. 

2.  JAVA-XML  DATA-BINDING 

Java-XML  Data-Binding  is  the  process  in  which  an  XML  document  is  converted  to  its 
equivalent  representation,  as  a  Java  object,  and  vice  versa.  The  Java™  Architecture  for  XML 
Binding  (JAXB)  Working  Draft  Specification  [SunOll  defines  XML  data-binding  as  a  facility 
containing  two  components:  A  schema  compiler  and  a  marshaling  framework.  As  shown  in 
Figure  II-8,  the  schema  compiler  reads  an  XML  schema  to  derive  a  set  of  Java  classes 
representing  the  structure  of  the  XML  documents  that  conform  to  the  XML  schema.  During 
runtime,  the  marshaling  framework  unmarshal  an  input  XML  document  into  instances  of  the 
derived  classes.  The  member  variables  of  these  derived  classes  provide  access  to  the  content 
of  the  input  XML  document’s  elements. 
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Figure  II-8.  XML  and  Java  Relationships  (from  [SunOl]). 


Java-XML  Data-Binding  makes  XML  easy  to  use  by  compiling  an  XML  schema  into 
one  or  more  Java  technology  classes.  The  marshaling  framework  and  the  derived  classes 
handle  all  the  details  of  XML  parsing  and  formatting.  Similarly,  the  generated  classes  ensure 
that  the  constraints  expressed  in  the  schema  are  enforced  in  the  resulting  methods  and  Java 
technology  language  data  types. 

E.  SUMMARY 

This  chapter  provided  an  introduction  to  the  OOMI,  which  is  a  methodology  for 
resolving  modeling  differences  between  systems,  and  the  OOMI  toolset  providing  computer 
aid  to  the  process.  The  next  chapter  will  discuss  the  requirements  of  the  OOMI  IDE 
Translation  Generator  and  the  OOMI  Translator.  The  FIOM  framework,  which  is  the 
foundation  of  the  OOMI  IDE  and  the  OOMI  Translator,  is  also  presented. 
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III.  RESOLVING  MODELING  DIFFERENCES  AMONG 

SYSTEMS  USING  OOMI 


A.  INTRODUCTION 

For  the  OOMI  IDE  Translation  Generator  and  OOMI  Translator  prototype,  Java  is  the 
implementation  language  while  XML  is  used  as  the  on-the-wire  format  for  information 
exchange  between  the  OOMI  Translator  and  the  component  systems.  Each  component  system 
is  expected  to  have  its  own  XML  schemas  that  describe  the  information  and  operations  it 
exports  or  imports.  XML  documents  conforming  to  these  schemas  will  be  transferred 
between  the  OOMI  Translator  and  the  component  systems  to  accomplish  infonnation 
exchange  and  joint  task  execution.  The  OOMI  Translator  is  responsible  for  invoking  the 
translations  to  perform  the  appropriate  transformations  required  for  each  component  system 
using  the  information. 

Figure  III- 1  illustrates  how  an  XML  document  exported  from  Component  System  A  is 
translated  to  the  various  formats  required  by  Component  Systems  1  to  N  by  the  OOMI- 
Translator.  The  XML  documents  being  transmitted  represent  the  different  views  of  the  same 
real  world  entity  that  is  used  by  the  component  systems. 
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Figure  III- 1 .  OOMI  operation  overview. 


Internally,  the  OOMI  Translator  converts,  or  unmarshals,  the  XML  documents  it 
receives  into  their  equivalent  Java  objects  (instances  of  OCR),  through  XML  data-binding. 
The  OCR  instances  (source  OCR  instances)  are  then  translated  to  their  corresponding  standard 
FOR  representation  (also  Java  objects).  For  each  destination  system,  the  translator  object, 
instantiated  by  the  OOMI  Translator,  will  resolve  differences  in  view  between  source  and 
destination  systems,  converting  the  source  FOR  instance  for  the  destination  system  into  a 
destination  FOR  instance.  This  destination  FOR  instance  is  then  translated  into  a 
corresponding  OCR  instance  for  the  destination  system.  The  logic  behind  the  translations 
between  an  FOR  instance  and  a  OCR  instance  is  defined  by  the  interoperability  engineer 
through  the  OOMI  IDE’s  Translation  Generator  module.  Finally,  the  destination  OCR 
instance  is  converted,  or  unmarshalled,  into  the  XML  document  expected  by  the  destination 
system.  This  process  is  further  elaborated  in  section  V.C.  A  detailed  description  of  the 
Translation  Generator  is  presented  in  Chapter  IV,  while  the  details  of  the  OOMI  Translator 
can  be  found  in  Chapter  V. 
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XML  had  been  chosen  for  the  prototype  implementation  of  the  OOMI  due  to  the 
following: 

1.  XML  is  the  most  widely  adopted  standard  for  information  exchange  on  the 
Internet. 

2.  Due  to  the  above,  there  is  availability  of  a  large  number  of  tools  and  software 
libraries  (both  commercial-off-the-shelf  and  open-source)  in  support  of  XML  and 
its  related  technologies.  They  are  also  available  on  most  operating  systems. 

3.  DoD  will  be  standardizing  on  XML  for  infonnation  exchange  between  DoD 
systems  [CY01]. 

4.  It  is  reasonable  to  assume  that  most  systems,  if  not  all,  that  export  data  to  other 
systems  and/or  import  data  from  other  systems  will  prefer  XML,  due  to  all  of  the 
above  reasons. 

The  Java  language  is  chosen  as  the  language  to  implement  the  translations  between 
XML  documents  rather  than  using  XSLT  (Extensible  Style  Language  Transformation)  due  to 
the  following  benefits  Java  has  over  XSLT : 

1 .  Strongly  typed 

2.  Better  readability 

3.  Better  scalability 

4.  Ease  of  maintenance 

5.  Full  capabilities  of  a  general  purpose  programming  language:  database  access, 
network,  access  to  distributed  components,  etc 

6.  Extensible  to  non-XML  based  object  transfer,  XSLT  can  only  be  applied  to 
XML  documents 

The  last  benefit  is  perhaps  the  most  important,  as  the  OOMI  is  not  dependent  on  XML 
to  achieve  its  objectives,  it  can  be  applied  to  any  information  exchange  format  equally  well. 
One  of  the  main  design  considerations  in  the  development  of  this  prototype  is  to  ensure  that 
extending  it  to  work  on  non-XML  documents  can  be  easily  achieved,  simply  by  using  a 
marshalling  framework  that  marshals  between  raw  binary  data  and  Java  objects.  A  good 
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example  would  be  the  object  serialization  mechanism  provided  by  the  Java  run-time 
environment. 

Two  major  components  of  the  OOMI  are  presented  in  chapters  IV  and  V,  namely,  the 
the  Translation  Generator  (a  module  incorporated  into  the  OOMI  IDE)  and  OOMI  Translator 
(a  run-time  component).  But  first,  the  requirements  of  the  Translation  Generator  and  the 
OOMI  Translator  are  discussed  in  sections  III.B  and  III.C.  The  underlying  framework  (FIOM 
Framework)  implemented  in  this  thesis  that  both  the  OOMI  IDE  and  OOMI  translator  use  as 
the  underlying  representation  of  the  FIOM  is  discussed  in  section  III.D. 

B.  TRANSLATION  GENERATOR  REQUIREMENTS 

The  primary  objective  of  the  translation  generator  is  to  provide  maximum  assistance  to 
the  interoperability  engineer.  The  generator  should  therefore  meet  the  following 
requirements: 

RG-1:  The  generator  should  aim  to  minimize  the  common  human  errors  that  may  occur  in  the 
definition  of  the  translation  logic. 

RG-2:  Code  Reuse 

■  The  environment  should  allow  the  user  to  add  code  to  perform  a  specific  attribute 
translation  into  a  central  repository,  so  that  the  code  can  be  reused  in  the  future  for 
other  FCR-CCR  translations. 

■  The  environment  should  allow  the  modification  of  code  in  the  code  repository  to 
correct  errors  and  allow  for  requirement  changes. 

■  A  major  concern  in  code  reuse  is  whether  to  reuse  through  inheritance  or  through 
duplication  (that  is,  copying  the  source  code  into  the  new  translation)  of  code 
fragments. 

■  A  major  advantage  of  inheritance  is  that  improvements  to  the  base  code  are 
immediately  reflected  in  all  the  translations  that  inherit  the  base  code.  On  the  other 
hand,  this  is  also  a  disadvantage  when  maintaining  a  larger  inheritance  base. 
When  the  base  code  is  changed,  there  is  a  need  to  perfonn  regression  testing  on  all 
affected  descendents,  which  may  be  very  costly  or  even  infeasible.  Also,  changes 
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to  base  code  may  not  need  to  be  propagated  to  all  translations  that  use  it.  Using 
inheritance  means  that  the  translations  are  tightly  coupled  to  the  central  repository. 

■  Duplication  of  code  has  the  disadvantage  that  changes  to  the  base  code  cannot  be 
easily  propagated  to  the  translations  that  use  the  code,  if  propagation  is  desired. 
But  there  is  an  advantage  that  changes  to  the  base  code  is  isolated  and  the  user  can 
specify  only  those  translations  that  need  updating  and  test  only  the  affected 
translations,  rather  than  having  to  re-test  all  translations  that  use  the  base  code 
affected.  That  is,  there  will  be  less  coupling  between  translations  and  the  central 
code  repository. 

RG-3:  Custom  code 

■  The  user  should  have  freedom  in  inserting  custom  code  like  Java  import 
statements,  additional  methods  for  the  translation  other  than  the  standard  attribute 
translation  methods  and  additional  member  variables.  Additional  member 
variables  are  crucial  to  store  temporary  computation  results  that  may  be  required  in 
different  stages  of  translation,  providing  a  more  efficient  translation  process. 

■  Custom  code  is  required  to  support  situations  where  the  translation  is  not  a  simple 
functional  transformation,  such  as  situations  requiring  access  to  third  party  lookup 
tables  (for  example,  database  tables),  invocation  of  other  remote  objects,  etc. 

RG-4:  Many-to-one  attribute  translation 

■  It  is  possible  for  the  target  attribute  to  be  derived  from  the  values  of  more  than  one 
source  attribute.  In  this  case,  if  the  target  attribute  is  a  mandatory  attribute,  all 
source  attributes  contributing  to  its  derivation  are  also  mandatory  in  this 
translation. 

RG-5:  Preservation  of  precision  in  numerical  data  types 

■  When  translating  a  numerical  attribute  to  another  numerical  attribute,  care  should 
be  taken  to  ensure  there  is  no  loss  of  precision,  this  is  especially  a  concern  for 
floating  point  decimal  types.  It  is  proposed  that  the  Java  type  BigDecimal  be  used 
whenever  possible,  unless  there  is  an  overriding  concern  for  performance. 

RG-6:  Attributes  of  the  target  class  should  not  be  dependent  on  each  other  during  the 
translation. 
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■  That  is,  in  the  translation  of  class  A  with  attributes  Al,  ...  ,  An,  from  class  B,  none 
of  Ai  should  rely  on  any  value  Aj  (  j  -t-  i  )  .  This  requirement  simplifies  the 
generator’s  design,  since  there  is  no  necessity  to  specify  the  order  in  which  each 
target  attribute  should  be  translated. 

RG-7:  The  translation  generated  should  be  independent  of  the  on- the -wire  transmission 
format,  in  this  case,  XML. 

The  translation  generator  being  implemented  for  this  thesis  is  a  prototype,  therefore,  it 
does  not  fully  implement  the  requirements  listed  above. 

Requirements  RG-2  and  RG-3  are  not  addressed  in  this  prototype.  It  was  felt  that 
these  two  requirements  can  be  adequately  addressed  with  the  integration  of  the  OOMI  IDE 
with  a  commercial  Java  IDE  that  will  provide  management  of  code  libraries  and  syntax 
assistance  (for  example,  JBuilder’s  Codeinsight). 

Requirement  RG-5  is  not  implemented,  since  it  is  actually  a  constraint  to  be  placed  on 
the  XML  data-binding  tool. 

C.  OOMI  TRANSLATOR  REQUIREMENTS 

The  main  function  of  the  OOMI  Translator  is  to  resolve  differences  in  views  and 
representations  between  a  federation’s  component  systems  during  runtime.  The  requirements 
of  the  OOMI  Translator  are  laid  out  in  this  section: 

RT-1:  Resolve  differences  in  views  and  representations  for  the  infonnation  sent  from  one 
system  (source  system)  to  another  system  (destination  system). 

RT-1.1:  The  following  input  to  the  OOMI  Translator  are  required: 

RT-1. 1.1:  The  FIOM  for  the  federation. 

RT-1. 1.2:  An  instance  of  the  information  of  a  real-world  entity,  fonnatted  in  the 
unique  representation  of  the  source  system  in  the  federation. 

RT-1. 1.2.1:  The  information  shall  be  contained  in  an  XML  document 

(source  XML  document)  conforming  to  the  XML  schema  of  the  CCR 
within  the  FIOM  associated  with  the  source  system. 

RT-1. 1.2. 2:  The  uniform  resource  identifier  (URI)  identifying  the  XML 
schema  of  the  root  element  of  the  source  XML  document  is  required  if 
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the  URI  cannot  be  determined  from  the  source  XML  document.  If  the 
URI  can  be  detennined  from  the  source  XML  document,  then  the  URI 
shall  be  optional. 

RT-1.1.3:  The  name  of  the  destination  system  in  the  federation  that  will  be 
receiving  the  information. 

RT-1.2:  The  following  output  from  the  OOMI  Translator  shall  be  provided: 

RT-1.2.1:  An  instance  of  the  infonnation  of  the  real-world  entity,  translated  from 
the  source  system’s  unique  representation  and  formatted  in  the  unique 
representation  of  the  destination  system. 

RT-1.2. 1.1:  The  information  shall  be  contained  in  an  XML  document 

conforming  to  the  XML  schema  of  the  CCR  within  the  FIOM 
associated  with  the  destination  system. 

RT-1.3:  Modeling  differences  between  source  and  destination  systems  shall  be 

automatically  resolved  upon  receiving  an  XML  document  from  the  source 
system. 

RT-2:  Communications. 

RT-2.1:  Manage  connection  with  the  source  system  to  receive  the  information  sent 

from  the  source  system. 

RT-2. 1.1:  During  communication  with  the  source  system,  if  the  URI  cannot  be 
detennined  from  the  source  XML  document,  then  the  uniform  resource 
identifier  (URI)  identifying  the  XML  schema  of  the  root  element  of  the 
source  XML  document  is  required  from  the  source  system.  If  the  URI  can 
be  detennined  from  the  source  XML  document,  then  the  source  system 
does  not  necessarily  have  to  send  the  URL 

RT-2. 2:  Manage  connection  with  the  destination  system  to  send  the  translated 

infonnation  to  the  destination  system. 

The  OOMI  Translator  prototype  implemented  in  this  thesis  does  not  address 
requirement  RT-2. 
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D.  THE  FIOM  FRAMEWORK 


The  FIOM  Framework,  defined  in  the  package  mil.  navy,  nps.cs.oomi.fiom,  provides  the 
functionalities  required  for  implementing  the  OOMI  IDE  and  OOMI  Translator.  The  set  of 
Java  interfaces  in  this  framework  defines  the  objects  modeling  the  FIOM.  The  set  of  Java 
classes  defined  in  the  mil.navy.nps.es. oomi.impl  package  implements  these  interfaces  and 
provides  persistent  storage  to  an  XML  file. 

1.  FIOM  Framework  Requirements 

The  requirements  of  the  FIOM  Framework  are  as  follows: 

RF-1:  Provide  a  Java  object  model  implementing  the  FIOM. 

RF-2:  Provide  application  programming  interfaces  (APIs)  to  manage  a  collection  of 
FIOMs. 

RF-3:  Provide  APIs  to  store  the  collection  of  FIOMs  to  persistent  storage  and  to 
restore  the  collection  from  persistent  storage. 

2.  FIOM  Framework  Constraints 

The  following  constraints  were  imposed  on  the  FIOM  Framework: 

CF-F.  Uniqueness  of  names  within  a  FIOM. 

CF-1.1:  Within  a  FIOM,  each  component  system  is  identified  by  a  name. 

CF-1.2:  Within  a  FIOM,  each  FE  is  uniquely  identified  by  a  name. 

CF-1.3:  Identifiers  of  a  CCR. 

CF-1.3.F  Within  a  FIOM,  each  CCR  is  uniquely  identified  by  the  pair  of 
values  comprising  the  name  of  its  component  system  and  the  name  of 
the  CCR. 

CF-1.3. 2:  Within  a  FIOM,  each  CCR  is  uniquely  identified  by  the  pair  of 

values  comprising  the  name  of  its  component  system  and  the  uniform 
resource  identifier  (URI)  of  the  XML  schema  that  this  CCR 
corresponds  to. 
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CF-2:  Uniqueness  of  names  within  an  FE. 

CF-2.1:  Within  an  FE,  each  FEV  is  uniquely  identified  by  a  name. 

CF-3:  Each  FEV  is  exactly  represented  by  one  and  only  one  FCR. 

3.  The  FIOM  Framework  Components 

Within  the  constraints  described  in  section  III.D.2,  the  FIOM  Framework  was 
developed  to  satisfy  the  requiremenrts  for  the  OOMI  IDE  and  the  OOMI  Translator,  outlined 
in  sections  III.B  and  III.C,  respectively.  Figure  III-2  provides  an  overview  of  the  FIOM 
Framework. 

The  FIOM  Framework  consists  of  components  from  the  mil.navy.nps.cs.oomi, 
mil.navy.nps.es.  oomi.impl  and  mil.navy.nps.cs.oomi.fiom  packages.  The 
mil.navy.nps.cs.oomi  and  mil.navy.nps.cs.oomi.fiom  packages  were  implemented  using  pure 
interfaces  so  that  future  improvements  to  the  underlying  implementation  of  the  OOMI  IDE 
and  OOMI  Translator  can  perfonned  easily  by  replacing  only  the  classes  that  implement  these 
interfaces.  In  this  implementation,  the  classes  that  implement  these  interfaces  are  coded  in  the 
mil.navy.nps.es. oomi.impl  package.  The  complete  source  code  listing  of  the  FIOM 
Framework  is  included  in  Appendix  A. 

The  FIOM  Framework  was  designed  to  encapsulate  the  underlying  details  of  persistent 
storage.  Developers  requiring  access  to  the  FIOMs  in  the  OOMI  database  do  not  need  to  deal 
with  the  details  of  access  to  persistent  storage.  The  classes  used  to  implement  the  persistent 
storage  of  a  collection  of  FIOMs  in  the  fonn  of  an  XML  file  are  also  contained  in  the 
mil.navy.nps.es. oomi.impl  package. 
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Figure  III-2.  mil.navy.nps.cs.oomi  and  mil. navy. nps.cs.oomi.fiom  packages. 


The  OOMIDatabase  interface  in  the  package  mil.navy.nps.cs.oomi  is  to  be  used  by  the 
OOMI  IDE  to  handle  a  collection  of  FIOMs.  It  is  also  meant  to  be  used  by  the  OOMI 
Translator  to  load  a  specific  FIOM  from  persistent  storage,  for  use  by  the  Translator  object. 
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Finally,  the  components  that  define  the  FIOM  and  methods  to  manipulate  those 
components  are  contained  in  the  package  mil.navy.nps.cs.oomi.fiom.  The  first  component, 
the  FIOM  interface  is  to  be  used  by  Translator  object  to  perfonn  translations. 

The  FCR  interface  provides  the  meta  information  of  the  FCR,  composed  of 
FCRSchema,  FCRSemantics  and  FCRSyntax.  FCRSemantics  and  FCRSyntax  are  currently 
not  required  and  thus  not  implemented.  They  are  meant  to  be  used  by  the  OOMI  IDE 
correlator  module.  FCRSchema  interface  contains  the  complete  information  on  the  attributes 
of  the  FCR  and  the  name  of  the  Java  class  (descendent  of  FCRInstance )  which  when 
instantiated,  will  hold  the  values  of  the  FCR’s  attributes. 

The  CCR  interface  provides  the  meta  information  of  the  CCR,  composed  of 
CCRSchema,  CCRSemantics  and  CCRSyntax.  CCRSemantics  and  CCRSyntax  are  currently 
not  required  and  thus  not  implemented.  They  are  meant  to  be  used  by  the  OOMI  IDE 
correlator  module.  CCRSchema  interface  contains  the  complete  information  on  the  attributes 
of  the  CCR  and  the  name  of  the  Java  class  (descendent  of  CCRInstance )  which  when 
instantiated,  will  hold  the  values  of  the  CCR’s  attributes.  As  shown  in  Figure  III-3,  the  Castor 
data-binding  tool  is  used  in  the  OOMI  IDE  to  generate  an  object  representation  of  the 
component  system’s  XML  schema.  The  generated  class  shall  be  a  descendent  of 
CCRInstance.  A  CCR  is  uniquely  defined  by  the  SystemName  and  CCRName  pair  and  also 
uniquely  identified  by  the  SystemName  and  XMLNameSpaceURI  pair  within  the  FIOM.  The 
CCR  interface  also  provides  access  to  information  on  whether  an  attribute  of  its  FCR  is 
mandatory,  based  on  the  FCRtoCCR  attribute  mappings  contained  in  the  object  implementing 
this  interface. 


Figure  III-3.  Data-Binding  with  Castor. 
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The  Attribute  interface  component  describes  the  attribute  of  either  an  FCR  or  CCR, 
and  contains  infonnation  like  the  name,  data  type  and  the  minimum  and  maximum  number  of 
elements  allowed  if  the  attribute  is  an  array. 

Finally,  the  AttributeMapping  interface  describes  the  mapping  from  an  array  of 
attributes  to  a  specific  attribute.  It  is  used  to  hold  the  definition  of  attribute  mappings  between 
an  FCR  and  CCR. 

E.  SUMMARY 

The  requirements  of  the  Translation  Generator  and  the  OOMI  Translator  fonn  the 
basis  for  the  development  of  the  prototypes.  The  FIOM  Framework  defines  the  object  model 
implementing  the  FIOM  and  APIs  for  manipulating  and  managing  persistence  of  the  model. 

The  Translation  Generator  and  the  OOMI  Translator  prototypes  developed  for  this 
thesis  are  discussed  in  detail  in  chapters  IV  and  V,  respectively. 


30 


IV.  TRANSLATION  GENERATOR 


A.  INTRODUCTION 

A  Federation  Interoperability  Object  Model  (FIOM)  is  created  for  a  system  federation 
to  capture  the  infonnation  and  operations  shared  between  different  systems.  The  OOMI 
translator  perfonns  the  conversion  between  models  of  the  real-world  entities  whose 
information  and  operations  are  shared  among  systems  using  translations  contained  in  the 
FIOM.  An  automatic  translation  generator  is  provided  as  part  of  the  OOMI  IDE  to  provide 
computer-aided  assistance  to  the  Interoperability  Engineer  (IE)  in  defining  the  translations 
required. 

FIOM  translations  are  used  to  resolve  representational  differences  among  the  attributes 
and  operation  signatures  used  to  define  a  component  model  of  a  real-world  entity.  The 
process  of  defining  the  transformations  between  attribute  and  operation  signatures  is 
potentially  error-prone,  therefore  the  OOMI  IDE  should  aim  to  automate  the  processes  of 
translation  creation  in  order  to  minimize  chances  of  human  error  wherever  possible.  The 
translation  generation  algorithm  discussed  in  this  chapter  provides  such  automation  to 
translation  construction. 

For  the  OOMI  IDE  prototype,  the  OCRs  and  FCRs  are  represented  internally  as  Java 
classes  (CCRInstance  class  and  FCRInstance  class,  respectively)  produced  through  a  data- 
binding  process,  using  the  CASTOR  data-binding  tool.  The  translation  generator  will 
therefore  work  directly  with  Java  classes  and  utilize  the  Java  reflection  API  to  work  on 
compiled  Java  classes. 


B.  DEFINING  ATTRIBUTE  TRANSLATIONS 

This  section  will  describe  the  process  of  how  the  (IE)  uses  the  OOMI  IDE  translation 
generator  module  to  create  the  framework  for  a  translation  definition.  This  translation 
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“skeleton”  will  be  completed  by  the  IE  using  both  newly  created  and  previously  saved 
transformations.  A  simple  graphical  user  interface  was  developed  for  the  generator. 

As  discussed  in  section  II.B.2,  the  OOMI  uses  an  intermediate  representation  during 
the  translation  process  in  order  to  solve  the  0(n  )  translations  problem.  The  process  thus 
requires  definition  of  two  translations  for  each  source-destination  system  pair.  The  first 
translation  is  used  to  convert  between  the  source  system  Component  Class  Representation 
(CCR)  and  the  intermediate  Federation  Class  Representation  (FCR).  The  second  translation  is 
used  to  convert  from  the  intennediate  FCR  to  the  destination  CCR.  Thus  the  translation 
generation  module  is  used  to  create  translations  between  FCRs  and  CCRs. 

Figure  IV- 1  shows  the  user  interface  used  by  the  translation  generation  module  to 
create  such  FCR-CCR  translations.  As  seen  in  the  figure,  section  A  displays  an  FCR  and  its 
attributes,  while  section  B  shows  a  CCR  with  its  attributes.  Composite  FCR  or  CCR 
components  are  displayed  through  expansion  of  the  FCR  or  CCR  tree  structure. 


Figure  IV- 1 .  The  Translation  Generator  module. 
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To  define  a  mapping  between  the  FCR  attributes  name  and  string  l  and  the  CCR 
attribute  nameOfObject,  the  IE  selects  these  attributes  as  shown  and  hits  the  button, 
creating  a  mapping  from  “name, string  1”  to  “nameOfObject”;  the  FCR  to  CCR  mapping  is 
displayed  in  section  C: 


Figure  IV-2.  Defining  FCRInstance  to  CCRInstance  attribute  mapping. 
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To  define  the  reverse  mapping,  the  IE  uses  the  “4-”  button,  and  the  CCR  to  FCR 
mapping  is  displayed  in  section  D: 


Figure  IV-3.  Defining  CCRInstance  to  FCRInstance  attribute  mapping. 


Finally,  the  IE  clicks  the  “Generate  Skeleton”  button  to  generate  the  translation  code 
skeleton.  The  OOMI  IDE  then  provides  the  capability  to  modify  the  translation  code  skeleton 
to  add  functional  or  other  transformations  as  necessary  to  resolve  representational  differences. 
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C.  TRANSLATION  GENERATION  PROCESS 


The  OOMI  IDE  creates  a  GeneratorUI. Plugin  object  which  implements  the  user 
interface  shown  in  Figure  IV- 1.  The  translation  generation  process  begins  with  the  definition 
of  attribute  translations,  described  in  section  IV.B,  and  is  completed  when  the  IE  clicks  on  the 
“Generate  Skeleton”  button.  The  button  click  invokes  the  generateSkeleton( ...)  method  of 
GeneratorUI. Plugin  object,  plugin,  to  generate  the  code  skeleton.  This  process  is  illustrated 
in  Figure  IV -4. 


Figure  IV-4.  Sequence  diagram  for  the  translation  generation  process. 


As  shown  in  Figure  IV-4,  the  generateSkeleton( ...)  method  performs  the  following: 

1.  Create  a  JavaFileDefinition  object,  fileDef,  by  invoking  the  static  method 
newFiomTranslationFileQ  of  TranslationFactory  class.  The  object,  fileDef, 
defines  the  content  of  the  Java  source  file  that  contains  the  code  skeleton  to  be 
generated. 
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2.  Invokes  getPublicClass()  method  of  fileDef  to  retrieve  the 

TranslationClassDefinition  instance,  classDef,  from  fileDef.  The 

TranslationClassDefinition  instance  defines  the  methods  of  the  Java  class 
implementing  the  translation. 

3 .  For  each  AttributeMapping  in  the  Trans lationMap,  plugin  fcrToCcr , 

add  this  attribute  mapping  to  the  CCR,  by  calling 
addFCRToCCRAttributeMapping(...)  of  the  CCR , 
call  TranslationFactory.newFcrToCcrMethod(...)  to  create  an 
AttributeTranslationMethod  object,  and  add  this  object  to  classDef,  by  invoking 
classDef  addMethod( ...) 

4.  For  each  AttributeMapping,  attr,  in  the  TranslationMap,  ccrToFcr, 

call  TransIationFactory.newCcrToFcrMethod(...)  to  create  a 
AttributeTranslationMethod  object,  and  add  this  object  to  classDef,  by  invoking 
classDef  addMethod( ...) 

5.  Generate  the  source  code  for  the  abstract  methods  toFCR  and  toCCR,  defined  in 
AbstractTranslation 

6.  Create  a  new  Trans lationGenerator  object  and  invoke  its  generate(...)  method  to 
generate  the  source  code  for  the  skeleton. 
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D.  TRANSLATION  GENERATOR  IMPLEMENTATION 


The  classes  used  to  implement  the  Translation  Generation  process  discussed  in  section 
IV. C  are  shown  in  Figure  IV-5.  A  brief  description  of  each  of  these  component  classes 
follows  the  figure.  The  complete  source  code  listing  of  the  Translation  Generator  is  included 
in  Appendix  B. 


«Uses» 


Figure  IV-5.  Class  diagram  of  the  Translation  Generator. 


GeneratorUI  -  A  factory  class  that  will  create  an  instance  of  the  inner  class 
GeneratorUI. Plugin,  which  implements  the  user-interface  for  the  Translator  Generator 
module. 

GeneratorUI. Plugin  -  The  inner  class  implementing  the  user-interface  for  the 
Translator  Generator  plugin  to  the  OOMI  IDE. 
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Attributes TreeModel  and  AttributeNode  -  Provides  the  data  model  required  by  the 
Java  Swing  JTree  components  (sections  A  and  B  in  Figure  IV- 1)  for  the  display  of  a  class  and 
its  attributes. 

TranslationMapTableModel  -  Provides  the  data  model  required  by  the  Java  Swing 
JTable  components  (sections  C  and  D  in  Figure  IV- 1)  for  the  display  of  attribute  mappings. 

TranslationFactory  -  A  factory  to  create  various  FIOM  translation  specific  class 
instances,  suhc  as  instances  of  AttributeTranslationMethod  and  JavaFileDefinition. 

JavaFileDefinition  -  Defines  a  Java  source  file  containing  the  code  skeleton  to  be 
generated.  It  contains  an  instance  of  ClassDefinition  representing  the  public  class  contained 
in  the  Java  source  file. 

ClassDefinition  -  An  instance  of  this  class  defines  a  Java  class  that  implements  the 
translation  being  defined.  The  set  of  MethodDejinition  objects  contained  within  a 
ClassDefinition  object  represents  the  methods  of  the  class  defined  by  ClassDefinition 

TranslationClassDefinition  -  A  subclass  of  ClassDefinition  specialized  to  represent 
the  source  code  of  a  subclass  of  AbstractTranslation.  AbstractTranslation  class,  described  in 
detail  in  section  III.E,  is  used  by  the  OOMI  Translator  to  represent  a  translation. 

MethodDefinition  -  An  instance  of  this  class  represents  the  definition  of  a  Java 
method. 

AttributeTranslationMethod  -  A  subclass  of  MethodDefinition  defining  a  FIOM 
attribute  translation.  Contains  additional  information  required  to  generate  translations, 
specifying  the  target  attribute  that  this  method  is  meant  to  translate  to. 

MethodP arameter  -  An  instance  of  this  class  represents  a  parameter  of  a  method 
defined  by  MethodDefinition. 

TranslationAttribute  -Describes  an  attribute  of  a  class  in  the  FIOM.  An  attribute,  if 
not  a  Java  primitive  type,  can  be  a  parent  to  other  attributes,  forming  a  tree  structure  that 
reflects  the  structure  of  this  non-primitive  attribute. 

TranslationMap  -  Keeps  a  collection  of  attribute  mappings  between  two  classes.  The 
collection  will  be  composed  of  one  or  more  TranslationAttributeMapping  objects. 
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TranslationAttributeMapping  -  Holds  the  many-to-one  mapping  from  attributes  of  one 
class  to  the  attribute  of  another  class. 

TranslationGenerator  -  Contains  the  logic  to  generate  Java  source  code  for  a 
translation,  based  on  the  information  contained  in  a  JavaFileDefinition  object. 


E.  GENERATED  TRANSLATION  CLASS  HIERARCHY 

All  translations  generated  are  sub-types  of  the  class  AbstractTranslation  in  the 
package  mil.navy.nps.es. oomi.fiom,  depicted  in  Figure  IV-6.  The  OOMI  translator  makes  use 
of  the  abstract  base  class  AbstractTranslation  to  carry  out  the  translations.  Specifically,  the 
OOMI  translator  makes  use  of  the  following  abstract  methods  defined  in  the  abstract  base 
class: 

■  toCCR(fcr:  FCRInstance)  -  translates  the  specified  FCRInstance  object  to  a 
CCRInstance  object 

■  toFCR(ccr:  CCRInstance)  -  translates  the  specified  CCRInstance  object  to  an 
FCRInstance  object 


Figure  IV-6.  Class  hierarchy  of  the  generated  translations. 
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The  IE  will  use  the  Translation  Generator  to  create  an  FCRCCRTranslation  class 
that  extends  the  AbstractTranslation  class  for  each  FCR-CCR  pair  defined  in  the  FIOM  as 
indicated  in  Figure  IV-6.  Each  FCR  CCR  Translation  class  will  implement  the  toCCR  and 
toFCR  abstract  methods  from  AbstractTranslation.  These  methods  will  invoke  a  number  of 
sub-methods  to  perform  the  translation  on  an  attribute-by-attribute  basis  as  follows: 

■  method  toCCR  will  invoke  one  or  more  methods  with  names  having  the  prefix 
fcrToCcr_;  these  methods  are  responsible  for  deriving  one  CCR  attribute  from 
one  or  more  FCR  attributes 

■  method  toFCR  will  invoke  one  or  more  methods  with  names  having  the  prefix 
ccrToFcr_;  these  methods  are  responsible  for  deriving  one  FCR  attribute  from 
one  or  more  CCR  attributes 

Two  method  signatures  are  possible  for  translating  attributes  {  Bi  ,  B2  ,  ...  ,  Bn  }  of  a 
certain  FCR  to  attribute  ccrA  of  a  corresponding  CCR: 

1 .  public  int  fcrToCcr_ccrA(  FCRInstance  fcr  ) 

■  This  does  not  restrict  the  attributes  that  the  method  can  access  in  the 
translation,  making  the  optional/mandatory  aspects  hard  to  handle 

■  The  fields  in  the  parameter  fcr  can  be  inadvertently  modified  by  the 
code  in  the  method,  this  is  a  potential  source  of  errors 

2.  public  int  fcrToCcr_ccrA(  Bi  ,  B2  ,  . . .  ,  Bn  ) 

■  This  restricts  the  method  body  on  the  source  attributes  that  it  can 
access,  thereby  providing  an  easy  way  for  the  tool  to  determine  if  all 
required  attributes  Bi  ,  B2  ,  ...  ,  Bn  are  present  and  for  the  tool  to 
generate  the  dependency  of  any  attribute 

■  This  format  also  provides  a  contract  on  what  attributes  can  be  used  in 
the  computation  of  attribute  ccrA 

■  The  fields  of  the  source  object  cannot  be  modified  within  the  method, 
as  long  as  all  the  parameters  Bi  ,  B2  ,  ...  ,  Bn  are  immutable  objects  or 
primitive  data  types 
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Option  2  was  determined  to  be  more  helpful  to  the  interoperability  engineer. 
The  ccrToFcr_  methods  are  symmetrical  to  the  above: 

■  public  int  ccrToFcr_fcrB(  CCRInstance  ccr  ) 

■  public  int  ccrToFcr_fcrB(  Ai  ,  A2  ,  ...  ,  An  ) 


F.  THE  GENERATED  TRANSLATION  SKELETON 

The  translation  skeleton  generated  by  the  generator  in  Figure  IV-7  below  is  an 
example  of  what  the  code  the  Translation  Generator  will  provide  for  an  FCR-CCR  pair  based 
on  the  attribute  mappings  specified  by  the  IE. 
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backage  Translations .testclasses.testclasses; 


//%%  begin  import 

//  —  Enter  your  additional  imports  here. 

//%%  end  import 

public  class  SampleFCRInstance _ SampleCCRInstance  extends 

mil . navy . nps . cs . oomi . f iom. AbstractTranslation  { 

//%%  begin  fields 

//  —  Enter  your  custom  fields  here. 

//%%  end  fields 

public  SampleFCRInstance _ SampleCCRInstance  (  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

init (  testclasses . SampleFCRInstance . class ,  testclasses . SampleCCRInstance . class  ); 
//%%  end  method_body 

} 

public  java . lang . String  f crToCcr_bigName  (  java . lang . String  name  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

//%%  end  method_body 

> 

public  int  f crToCcr__timeStamp  (  int  hour  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

//%%  end  method_body 

} 

public  java . lang . String  ccrToFcr_name  (  java . lang . String  bigName  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

//%%  end  method_body 

} 

public  int  ccrToFcr_time_hour  (  int  timestamp  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

//%%  end  method_body 

} 

public  mil . navy . nps . cs . oomi . fiom. CCRInstance  toCCR  ( 

mil . navy . nps . cs . oomi . f iom. FCRInstance  fcrlnstance  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

testclasses . SampleFCRInstance  obj  =  (testclasses . SampleFCRInstance)  fcrlnstance; 
testclasses . SampleCCRInstance  result  =  new  testclasses . SampleCCRInstance () ; 

result . set BigName ( f crToCcr_bigName (ob j . get Name ( ) ) )  ; 

result . setTimeStamp (f crToCcr_timeStamp (obj . getTime ( ) . getHour ( ) ) ) ; 

return  result; 

//%%  end  method_body 

} 

public  mil . navy . nps . cs . oomi . fiom. FCRInstance  toFCR  ( 

mil . navy . nps . cs . oomi . fiom. CCRInstance  ccrlnstance  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

testclasses . SampleCCRInstance  obj  =  (testclasses . SampleCCRInstance)  ccrlnstance; 
testclasses . SampleFCRInstance  result  =  new  testclasses . SampleFCRInstance () ; 

result . setTime (new  testclasses .UTC ( ) )  ; 

result . setName (ccrToFcr_name (obj . getBigName ( ) ) ) ; 

result . getTime ( ) . setHour (ccrToFcr_time_hour (obj . getTimeStamp ( ) ) ) ; 

return  result; 

//%%  end  method_body 

} 

//%%  begin  methods 

//  —  Enter  your  custom  methods  here. 

//%%  end  methods 


Figure  IV-7.  Sample  Translation  Skeleton. 
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The  sample  code  illustrates  the  translation  defined  for  the  classes  SampleFCRInstance 
and  SampleCCRInstance,  shown  in  Figure  IV- 8.  The  translations  between  the 
SampleFCRInstance  attributes  “Name”  and  “Hour”  (Hour  is  an  attribute  of  the  attribute  Time 
in  SampleFCRInstance),  and  the  SampleCCRInstance  attributes  “BigName”  and 
“TimeStamp”  are  shown. 


Figure  IV-8.  Defining  mappings  between  SampleFCRInstance  and  SampleCCRInstance. 
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The  code  contains  the  following  methods  of  interest: 

■  public  java.  Icing.  String  fcrToCcr_bigName  (  java. king. String  name  ) 

-  given  the  value  of  the  FCRInstance’s  name  attribute,  translates  it  to  the 
CCRInstance’s  BigName  attribute  and  returns  the  result 

■  public  int  fcrToCcrtimeStamp  (  int  hour  ) 

-  given  the  value  of  the  FCRInstance’s  hour  attribute,  translates  it  to  the 
CCRInstance’s  TimeStamp  attribute  and  returns  the  result 

■  public  java.lang.  String  ccrToFcr _name  (  java.lang.  String  bigName  ) 

-  given  the  value  of  the  CCRInstance’s  BigName  attribute,  translates  it  to  the 
FCRInstance’s  Name  attribute  and  returns  the  result 

■  public  int  ccrToFcr_time_hour  (  int  timeStamp  ) 

-  given  the  value  of  the  CCRInstance’s  TimeStamp  attribute,  translates  it  to  the 
FCRInstance’s  Hour  attribute  and  returns  the  result.  This  method  is  named 
ccrToFcr _time_hour  since  the  “Hour”  attribute  is  actually  a  sub-attribute  in  the 
“Time”  attribute  of  SampIeFCRInstance 

■  toCCR 

-  calls  each  of  the  fcrToCcr_  methods  to  convert  the  specified  FCRlnstance  into  a 
CCRInstance 

■  toFCR 

-  calls  each  of  the  ccrToFcr _  methods  to  convert  the  specified  CCRInstance  into 
an  F  CRInstance 

Special  markers  “//%%”  are  used  to  delimit  the  sections  of  code  that  are  generated  by 
the  generator  and  sections  where  the  interoperability  engineer  can  directly  manipulate  the 
code.  This  is  meant  for  future  implementation  of  round-trip  engineering  capability,  where  the 
translations  can  be  directly  imported  back  into  the  IDE  for  editing  and  re-generation  without 
overwriting  the  code  entered  by  the  interoperability  engineer.  The  IE  will  enter  the  code  for 
performing  the  attribute  translation  between  the  lines 

//%%  begin  method_body  --  Enter  method  body  below: 
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and 


//%%  end  method_body 

for  all  methods  with  names  beginning  with  ccrToFcr_  orfcrToCcr_. 

G.  SUMMARY 

The  Translation  Generator  described  in  this  chapter  provides  a  simple  graphical  user 
interface  for  defining  mappings  between  FCR  attributes  and  CCR  attributes,  and  the  capability 
to  generate  the  Java  source  code  for  a  skeleton  translation  class  that  will  perform  the 
translations  between  an  F CRInstance  object  and  a  CCRlnstance  object. 

The  skeleton  translation  classes  generated  by  the  Translation  Generator  will  be  used 
by  the  OOMI  Translator  (described  in  chapter  V)  to  resolve  differences  in  views  and 
representations  between  the  source  and  destination  systems. 
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V.  OOMI  TRANSLATOR 


A.  INTRODUCTION 

The  OOMI  Translator  is  the  run-time  component  responsible  for  resolving 
heterogeneities  among  systems  to  enable  interoperation.  The  Translator  converts  information 
shared  between  two  systems  from  its  source  system  model  to  the  model  expected  by  the 
destination  system.  In  its  current  implementation,  information  exported  from  or  imported  to  a 
component  system  is  provided  in  the  fonn  of  an  XML  document.  This  XML  document 
conforms  to  an  XML  schema  that  defines  a  real-world  entity  whose  attributes  and  operations 
are  being  shared  between  systems. 

The  current  implementation  of  the  Translator  translates  source  XML  documents  into 
destination  XML  documents  by  utilizing  the  translations  defined  in  the  FIOM. 

The  Translator  is  implemented  as  a  Java  class  that  is  independent  of  the  transport 
mechanism  to  be  used  to  perform  the  communication  between  systems.  The  Translator  class 
is  designed  to  be  easily  incorporated  into  any  application  that  will  utilize  the  OOMI  for 
interoperability. 

Figure  V-l  provides  an  overview  of  the  Translator’s  function  and  depicts  its 
relationship  with  the  other  components  of  the  OOMI.  In  particular,  Figure  V-l  depicts  how 
the  OOMI  Translator  uses  translations  and  component  model  relationships  contained  in  the 
OOMI  IDE  developed  FIOM  to  perform  the  translation  between  source  and  destination  model 
XML  documents. 
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Figure  V-2  illustrates  the  typical  scenarios  used  for  converting  a  source  system  XML 
document  to  a  model  usable  by  a  destination  system.  A  top-level  view  of  that  process  is 
provided  in  the  discussion  following  the  figure. 
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send( 

SourceSystemName, 

XMLDoc, 

XMLDocNamespaceURI, 
DestinationSystemName  ) 


-create(fiom:  FIOM)- 


The  translate  method 
determines  the  best- 
match  for  the 
DestinationSystem 
and  translates 

/ 

accordingly. 


translate( 

SourceSystemName, 
XMLDocNamespaceURI, 
XMLJnputStream, 
DestinationSystemName, 
XML_OutputStream  ) 


receive(  I 

SourceSystemName,  | 
XMLDoc)  | 

►I 


true 


Figure  V-2.  Typical  scenario  of  a  translation. 


send(...)  -  In  the  first  step,  the  source  system  packages  the  information  it  needs  to 
export  into  an  XML  document  (XMLDoc),  establishes  a  connection  to  the  OOMI  Translator 
and  sends  XMLDoc  to  it.  Additional  information  required  by  the  OOMI  Translator  includes 
the  source  system  name,  the  URI  of  the  XML  schema  defining  XMLDoc  and  the  destination 
system’s  name.  The  URI  of  the  XML  schema  of  XMLDoc  could  be  extracted  from  XMLDoc 
itself  by  the  OOMI  Translator  if  it  is  included  in  XMLDoc  (inclusion  of  the  reference  to  the 
URI  of  an  XML  document’s  schema  is  optional),  with  a  slight  overhead  on  the  part  of  the 
OOMI  Translator. 

create(...)  -  Next,  the  OOMI  Translator  creates  an  instance  of  the  Translator  class, 
with  a  FIOM  instance  defined  for  this  federation. 

translate(...)  -  The  OOMI  Translator  then  initiates  the  translation  process  by  invoking 
the  translate()  method  of  the  translator,  specifying  the  name  of  the  source  system,  the  XML 
namespace  URI  of  the  schema  for  XMLDoc,  an  input  stream  instance  supplying  the  content  of 
the  XML  document,  the  name  of  the  destination  system  and  an  output  stream  instance  where 
the  translated  document  can  be  written  to.  The  translate(...)  method  will  detennine  the  best 
translation  for  the  destination  system;  this  process  is  further  described  in  section  D.3  of  this 
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chapter.  The  tr  ansi ate  (...)  method  returns  true  if  the  translation  is  successful  and  false 
otherwise. 

receive(...)  -  The  OOMI  Translator  will  forward  the  translated  document  to  the 
destination  system,  together  with  the  name  of  the  source  system. 

The  application  utilizing  the  OOMI  will  implement  the  OOMI  Translator  according  to 
its  specific  requirements.  Three  architectural  alternatives  are  possible,  as  presented  in  the  next 
section. 

B.  OOMI  TRANSLATOR  IMPLEMENTATION  ARCHITECTURAL 
ALTERNATIVES 

As  mentioned  in  the  preceding  section,  the  OOMI  translator  class  was  meant  to  be 
incorporated  into  a  translator  (OOMI  Translator)  that  will  handle  the  details  of  networking 
between  the  component  systems.  In  this  section,  the  different  architectural  alternatives  in 
which  the  OOMI  Translator  can  be  implemented  are  presented.  These  alternatives  include 
implementation  as  a  wrapper  around  either  the  source  system,  destination  system,  or  both 
source  and  destination  systems;  or  as  a  standalone  server  which  functions  as  a  middleman  for 
information  exchange. 

1.  OOMI  Translator  on  a  Central  Server 

In  the  first  implementation  alternative,  each  component  system  communicates  with  the 
OOMI  Translator  running  on  a  central  server  as  depicted  in  Figure  V-3.  The  OOMI 
Translator  is  not  required  to  be  implemented  on  the  component  systems  and  each  component 
system  only  needs  to  transmit/receive  data  in  their  own  native  format.  Of  course,  a 
communication  protocol  must  be  agreed  upon  between  the  central  server  and  the  component 
systems. 


50 


Figure  V-3.  OOMI  Translator  located  on  a  central  server. 


2.  OOMI  Translator  on  One  Component  System 

Figure  V-4  shows  a  second  architectural  alternative  where  the  OOMI  Translator  is 
implemented  as  a  wrapper  on  one  of  two  interoperating  systems.  Here,  two  interoperating 
systems  may  use  their  own  communication  protocol  to  exchange  infonnation  between  them. 
The  on-the-wire  format  for  infonnation  exchanged  between  systems  will  be  the  native  format 
of  the  system  without  the  OOMI  Translator. 


Figure  V-4.  OOMI  Translator  on  One  Component  System. 


3.  OOMI  Translator  on  All  Component  Systems 

The  final  alternative,  depicted  in  Figure  V-5,  shows  the  OOMI  Translator 
implemented  as  a  wrapper  around  each  component  system.  Information  is  exchanged 
between  the  component  systems  in  an  intermediate  format  internal  to  the  OOMI  Translators. 
The  OOMI  Translators  on  each  system  will  need  to  implement  a  communication  protocol 
between  them. 
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Figure  V-5.  OOMI  Translator  on  All  Component  Systems. 


C.  THE  TRANSLATE  PROCESS 

The  translate  process  identified  in  Figure  V-2  and  briefly  introduced  in  section  V.A  is 
further  detailed  in  Figure  V-6  and  discussed  below.  The  sequence  diagram  depicted  in  Figure 
V-6  illustrates  the  translation  process,  when  the  translate()  method  of  the  OOMI  Translator 
object  is  invoked  on  a  received  XML  instance  document. 


52 


A  discussion  of  the  objects  involved  and  the  messages  exchanged  between  them 
during  translation  follows. 
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Translator  object  -  This  object  is  an  instance  of  the  Translator  class,  which 
implements  the  logic  for  resolution  of  differences  in  views  and  representations,  as  specified  in 
requirement  RT-1 . 

FIOM  object  -  This  object  models  the  FIOM  of  the  federation.  It  is  passed  to  the 
Translator  object  when  the  Translator  object  is  created. 

CCRInstance  object  -  This  object  is  the  result  of  the  translation,  it  is  subsequently 
marshaled  into  an  XML  document. 

createSourceInfo( '...)  -  upon  receipt  of  a  translate  message  from  the  OOMI  Translator, 
the  Translator  object  creates  a  Translator  Sour celnfo  object  containing  the  source  system 
name,  source  FCR  object,  source  CCR  object  and  a  method  to  determine  if  a  source  FCR 
attribute  has  a  value.  Within  this  method,  the  XML  document  is  unmarshaled  into  its 
corresponding  CCRInstance  object. 

jindCCR(...)  -  the  translator  invokes  the  jindCCR( ...)  method  of  the  FIOM  to  list  all 
the  OCRs  associated  with  the  destination  system. 

JindDestinations()  -  Returns  an  array  of  eligible  destination  OCRs,  in  ascending  order 
of  eligibility.  A  destination  CCR  is  considered  more  eligible  than  another  if  it  has  more  of  its 
attributes  matched  by  the  source  FCR.  One  of  the  major  capability  of  the  Translator  is  to 
automatically  determine  the  “best”  destination  FCR  to  use  for  a  destination  system.  This 
functionality  is  implemented  in  the  findDestinationsQ  method.  The  algorithm  for  determining 
translation  is  summarized  as  follows  [Young02]: 

Search  the  FEV  Inheritance  Hierarchy  containing  the  received  intermediate 
object’s  defining  FCR  Schema  Class  for  an  FEV  containing  a  CCR  for  the  destination 
system.  If  such  a  CCR  is  found,  the  destination  CCR  Schema  Class  is  examined  to 
determine  if  all  mandatory  properties  (attributes  and  operations)  contained  in  the  CCR 
Schema  Class  have  a  corresponding  property  in  the  received  intermediate  object’s 
defining  FCR  Schema  Class. 
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IF 


1 .  all  the  mandatory  operations  have  corresponding  operations  in  the  received 
intermediate  object’s  defining  FCR  Schema  Class 

AND 

2.  the  mandatory  attributes  contained  in  the  destination  CCR  Schema  Class 
have  corresponding  attributes  and  the  attribute  had  a  value  set  in  the 
received  intermediate  object’s  defining  FCR  Schema  Class 

THEN  the  FCR-CCR  Translation  class  associated  with  the  destination  CCR 
Schema  is  used  to  convert  the  received  intermediate  FCR  Schema  Class 
instance  to  a  destination  CCR  Schema  Class  instance. 

For  the  initial  prototype  implementation,  condition  one  (mandatory  operations)  is  not 
considered,  since  this  implementation  only  deals  with  the  attributes. 

JindTranslation( ...)  -  the  translator  invokes  the  findTranslation( ...)  method  of  the 
FIOM  to  determine  the  class  name  of  the  AbstractTranslation  class  descendent  that  will 
perform  the  translation. 

«create»  -  the  translator  instantiates  the  specific  translation  class  and  invokes  the 
toCCRQ  method,  which  will  perfonn  the  translation  and  returns  an  instance  of  CCRInstance. 

marshal(...)  -  the  translator  invokes  the  marshal(...)  method  of  the  CCRInstance 
object  to  convert  the  CCRInstance  object  into  an  XML  stream. 

true  -  finally,  the  translator  returns  true  indicating  a  successful  translation. 

The  complete  source  code  listings  of  the  Translator  class  is  included  in  Appendix  C. 

D.  SUMMARY 

The  OOMI  Translator  discussed  in  this  chapter  is  responsible  for  resolving 
heterogeneities  among  systems  during  runtime  to  enable  interoperation.  In  this  prototype 
implementation,  XML  documents  are  the  on-the-wire  format  exchanged  between  the 
component  systems. 
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VI.  CONCLUSION 


A.  RESULTS 

With  the  completion  of  the  OOMI  Translator  and  the  Translation  Generator  prototypes 
in  this  thesis,  it  should  be  clear  that  the  OOMI  is  achievable  and  is  a  practical  approach  to  the 
0(n)  translations  problem.  In  addition  to  addressing  the  0(n  )  translations  problem,  the 
OOMI  also  introduces  a  systematic  way,  based  on  Object-Oriented  Analysis  and  Design 
(OOAD),  in  defining  and  organizing  information  about  real-world  entities  that  can  be 
exchanged  between  component  systems  to  achieve  interoperability. 

Efficiency  of  the  translations  may  be  an  issue  in  high-performance  systems. 
Deploying  the  OOMI  Translator  directly  in  Java  bytecodes  may  not  be  sufficient  for  such 
systems.  An  attractive  alternative  would  be  to  compile  the  OOMI  Translator  and  the 
translation  classes  it  uses  into  the  native  machine  code  on  the  target  platforms  of  high- 
performance  systems.  The  fact  that  the  OOMI  Translator  does  not  require  any  graphical  user 
interface  makes  this  approach  possible,  using  compilers  such  as  TowerJ  [TowerJ], 


B.  FUTURE  WORK 

At  the  time  of  this  writing,  the  OOMI  toolset  is  far  from  being  complete.  The  most 
crucial  factor  in  the  acceptance  of  any  methodology  or  toolset  is  the  level  of  usability, 
automation  and  integration  with  other  tools.  The  following  areas  for  future  work  were 
identified  to  be  of  high  priority  for  the  OOMI  and  its  toolset  to  gain  acceptance: 

■  Two-way  editing  to  support  round-trip  development 

■  The  translation  generator  module  currently  does  not  support  two-way  editing, 
although  provisions  had  been  made  within  the  generated  source  code  to  support 
it. 

■  Since  software  development  is  an  iterative  process,  seamless  two-way  editing 
support  is  crucial  to  improve  the  usability  of  the  OOMI  IDE. 
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■  Support  for  automated  testing  of  translations  created  through  the  OOMI  IDE. 

■  Translation  code  editing/development 

■  The  OOMI  IDE  needs  to  be  integrated  with  a  commercial  Java  IDE  to  support 
development  of  the  translation  code.  The  Java  IDE  should  provide  the 
advanced  editing  and  debugging  features  required  by  the  interoperability 
engineer  for  development  of  any  non-trivial  translation. 

■  OOMI  Translator  and  networking  proxy  and  APIs 

■  The  OOMI  toolset  should  also  include  a  flexible  implementation  of  the  OOMI 
Translator  and  matching  networking  APIs  that  both  legacy  and  newly 
developed  systems  can  use  to  achieve  interoperability. 

■  The  OOMI  Translator  will  need  to  support  the  common  distributed  computing 
frameworks  like  SOAP,  CORBA,  DCOM  and  .Net. 

■  An  implementation  using  JINI  may  be  a  viable  solution,  due  to  JINI’s  built-in 
ability  to  distribute  code  transparently. 

■  The  OOMI  Translator  may  also  need  to  address  security  issues:  secrecy, 
integrity  and  non-repudiation. 

■  Supporting  real-time  systems 

■  With  the  recent  release  of  the  reference  implementation  of  Real-Time 
Specification  for  Java  [RTSJ]  Research  by  TimeSys  Corporation  [TimeSys], 
developing  true  real-time  systems  in  Java  is  finally  possible.  Research  into 
adapting  the  OOMI  Translator  in  real-time  Java  implementations  will  benefit 
the  application  of  OOMI  on  the  integration  of  real-time  systems. 
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APPENDIX  A.  FIOM  FRAMEWORK  SOURCE  CODE 


A.  PACKAGE:  mil.navy.nps.cs.oomi 

1.  OOMIDatabase.java 

package  mil.navy.nps.cs.oomi; 

import  mil.navy.nps.cs.oomi.*; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  This  interface  represents  the  database  that  contains 

*  the  FIOMs  maintained  by  the  OOMI  IDE, 

*  each  of  these  FIOMs  can  be  used  by  the  OOMI  Translator. 

*  It  serves  to  encapsulate  the  access  of  persistent 

*  storage  mechanisms. 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  interface  OOMIDatabase  { 

/** 

*  Returns  an  array  of  FIOMs  already  registered  in  this  OOMIDatabase. 

*  @return  Returns  an  array  of  FIOMs  already  registered  in  this  OOMIDatabase. 

*  Returns  an  empty  array  if  no  FIOM's  are  registered. 

*/ 

public  FIOM [ ]  getFIOM ( )  ; 

/** 

*  Returns  the  number  of  FIOM's  already  registered  in  this  database. 

*/ 

public  int  fiomCountO; 

/** 

*  Creates  a  new  FIOM  with  the  specified  name 

*  and  adds  it  to  this  OOMIDatabase. 
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*  Returns  a  the  newly  created  instance  of  FIOM  . 

*  @param  fiomName  A  unique  FIOM  name  for  the  new  FIOM. 

*  ©return  Returns  a  new  instance  of  a  FIOM  with  the  specified  name. 

*  ©throws  DuplicateKey  Throws  DuplicateKey  if  a  FIOM  with  the  same  name 

*  already  exists  in  this  OOMIDatabase . 

*/ 

public  FIOM  newFIOM(  String  fiomName  )  throws  DuplicateKeyException; 

/** 

*  Finds  a  FIOM  identified  by  the  specified  name. 

*  ©param  fiomName  The  name  of  the  FIOM  to  be  returned. 

*  ©return  Returns  FIOM  instance  identified  by  the  specified  name, 

*  returns  null  if  no  FIOM 

*  with  matching  (exact,  case-insensitive)  name  is  found. 

*/ 

public  FIOM  findFIOM(  String  fiomName  ); 

/** 

*  Returns  if  there  is  a  FIOM  with  the  specified  name  in  this  database. 
*/ 

public  boolean  fiomExists (  String  fiomName  ) ; 


2.  Sear  chHandler.  java 

package  mil . navy . nps . cs . oomi; 

/** 

*  ©author  LEE  ShongCheng 

*  ©version  1 . 0 
*/ 

public  interface  SearchHandler  { 

/** 

*  Indicates  whether  to  find  more. 

*/ 

public  boolean  carryOn () ; 

/** 

*  Indicates  whether  the  specified  object  satisfies  this  SearchCriteria . 
*/ 
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public  boolean  satisfied (Ob ject  obj); 


/** 

*  Adds  an  object  that  satisfies  this  criteria. 
*/ 

public  void  add (Object  obj); 


B.  PACKAGE:  mil.navy.nps.cs.oomi.fiom 

1.  AbstractTranslation.java 

package  mil . navy . nps . cs . oomi . f iom; 

import  mil . navy . nps . cs . oomi . f iom . FCRInstance ; 
import  mil . navy . nps . cs . oomi . f iom. CCRInstance ; 

//import  mil . navy . nps . cs . oomi . impl . * ; 

/** 

*  @author  LSC 

*  (Aversion  1 . 0 
*/ 

public  abstract  class  AbstractTranslation  ( 

/** 

*  The  FCR  that  this  translator  supports. 

*/ 

static  private  Class  _fcrInstanceClass; 

/** 

*  The  CCR  that  this  translator  supports. 

*/ 

static  private  Class  _ccrInstanceClass; 

/** 

*  Initializes  this  class  with  the  corresponding  FCR  and  CCR. 

*  It  is  recommended  that  fcr  and  ccr,  use  fully  qualified  class  names. 

V 

protected  static  void  init (  Class  fcrlnstanceClass,  Class  ccrlnstanceClass  )  ( 

setFCRInstanceClass (fcrlnstanceClass) ; 
setCCRInstanceClass (ccrlnstanceClass) ; 

) 
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/** 

*  Translates  to  FCR. 

*/ 

abstract  public  FCRInstance  toFCR(  CCRInstance  ccr  ); 

/** 

*  Translates  to  CCR. 

*/ 

abstract  public  CCRInstance  toCCR(  FCRInstance  fcr  ); 

/** 

*  Sets  the  FCR  that  this  translator  supports. 

*/ 

protected  static  void  setFCRInstanceClass (  Class  f crlnstanceClass  )  { 

_fcrInstanceClass  =  fcrlnstanceClass; 

} 

/"** 

*  Sets  the  CCR  that  this  translator  supports. 

*/ 

protected  static  void  setCCRInstanceClass (  Class  ccrlnstanceClass  )  ( 

_ccrInstanceClass  =  ccrlnstanceClass; 

} 

/** 

*  Returns  the  FCR  that  this  translator  supports. 

*/ 

public  static  Class  getFCRInstanceClass ( )  ( 

return  _f crlnstanceClass ; 

}; 


/** 

*  Returns  the  CCR  that  this  translator  supports. 
*/ 

public  static  Class  getCCRInstanceClass ( )  ( 

return  _ccrInstanceClass; 

}; 


2.  Attribute,  java 

package  mil . navy . nps . cs . oomi . f iom; 
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import  java . util . List ; 


import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  Contains  the  information  of  a  FCR  or  CCR  class  attribute. 

*  If  the  Attribute  is  an  array,  that  is,  isArray ( ) ==true, 

*  the  getTypeO  returns  the  type  of  the 

*  element  in  the  array. 

*  @author  LSC 

*  ©version  1 . 0 
*/ 

public  interface  Attribute  { 

/** 

*  The  standard  separator  for  the  name  path  to  an  Attribute 

*  that  is  a  descendent  of  another  Attribute. 

*/ 

public  final  String  NAME_SEPARATOR  = 

/** 

*  Creates  and  adds  a  new  child  attribute  for  this  object. 

*/ 

public  Attribute  newChild(  String  attributeName,  TypeName  attributeType) 
throws  UniqueNameViolationException  ; 


/** 

*  Removes  the  specified  descendent  from  this  attribute, 

*  there  should  only  be  one  instance  of  any  attribute  within  the  hierarchy, 

*  the  parent  field  of  the  descendent  is  cleared. 

*  ©param  descendentToRemove  The  descendent  to  be  removed. 

*  ©return  Returns  true  if  a  descendent  had  been  removed, 

*  false  if  no  descendent  is  removed,  that  is,  the  descendent  is 

*  not  found  within  this  Attribute.. 

*/ 

public  boolean  removeDescendent (  Attribute  descendentToRemove  ) ; 

/** 

*  Creates  an  exact  copy  of  this  Attribute. 

*/ 
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public  Attribute  copyO; 


/** 

*  Returns  the  number  of  children  of  this  object . 

*/ 

public  int  childCount  ( ) ; 

/** 

*  Returns  the  name  of  this  attribute. 

*/ 

public  String  getNameO; 

/** 

*  Sets  the  name  of  this  attribute. 

*/ 

public  void  setName (String  name) ; 

/** 

*  Sets  the  type  of  this  Attribute. 

*/ 

public  void  setType  (TypeName  type) ; 

/'** 

*  Returns  the  type  of  this  Attribute. 

*/ 

public  TypeName  getTypeO; 

/** 

*  Returns  the  parent  of  this  attribute,  returns  null  if  this  attribute  has 

*  no  parent,  that  is,  it  is  the  root  attribute. 

*  ^return  Returns  the  parent  of  this  attribute,  returns  null  if  this  attribute  has 

*  no  parent,  that  is,  it  is  the  root  attribute. 

*/ 

public  Attribute  getParentO; 

/** 

*  Returns  the  children  (grandchildren  excluded)  of  this  attribute. 

*/ 

public  Attributed  getChildO; 

/** 

*  Finds  a  child  attribute  matching  (not  case-sensitive)  the  specified  name. 

*/ 

public  Attribute  findChild (String  childName) ; 
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/** 

*  Finds  a  descendent  attribute  who  is  equal  to  the  specified  Attribute  attr. 
*/ 

public  Attribute  f indDescendent (Attribute  attr) ; 

/** 

*  Enumerates  all  descendents  and  add  them  to  the  specified  list, 

*  effectively  flattening  the  attribute  tree  into  a  list. 

*/ 

public  void  enumerateDescendents (  List  result  ) ; 

/** 

*  Returns  an  array  of  all  ancestors  of  this  Attribute,  from 

*  greatest  grandparent  to  this  Attribute. 

*  ^return  Returns  an  array  of  all  ancestors  of  this  Attribute,  from 

*  greatest  grandparent  to  this  Attribute. 

*/ 

public  Attribute!]  pathToArray ( ) ; 

/** 

*  Determines  if  the  given  Attribute  is  equal  to  this  object . 

*  Dreturn  Returns  true  if  and  only  if  ( 

*  this . getName  ( )  . equals (attr . getName ( ) ) 

*  &&  this . getType (). equals (attr . getType () ) 

*  &&  this . getParent (). equals (attr . getParent  () ) 

*  ) 

*/ 

public  boolean  equals (  Object  attrObj  ) ; 

/** 

*  As  required  by  the  general  contract  of  Ob ject . hashCode ( ) , 

*  implementations  of  Attribute  shall  ensure  that  for  any  Attribute  al,  a2, 

*  al . equals (a2)  implies  al . hashCode () ==a2 . hashCode () . 

*/ 

public  int  hashCode (); 

/** 

*  Returns  true  if  this  attribute  is  mandatory,  false  otherwise. 

*  ^return  Returns  true  if  and  only  if  getMinOccurs ( ) >=1 
*/ 

public  boolean  isMandatory ( ) ; 
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/** 

*  Returns  the  full  name  path  of  this  Attribute  within  the  Attribute  tree. 
*/ 

public  String  fullPath(); 

/** 

*  Returns  true  if  this  attribute  is  an  array  type. 

*  @return  Returns  true  if  this  attribute  is  an  array  type. 

*/ 

public  boolean  isArrayO; 

public  int  getMinOccurs ( )  ; 
public  void  setMinOccurs (  int  v  ) ; 
public  int  getMaxOccurs ( )  ; 
public  void  setMaxOccurs (  int  v  )  ; 

} 

3.  AttributeMapping.java 

package  mil . navy . nps . cs . oomi . f iom; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  interface  AttributeMapping  { 

public  Attribute!]  f romAttributes ( )  ; 

public  Attribute  toAttribute ( )  ; 

} 


4.  CastorHelper.java 

package  mil . navy . nps . cs . oomi . f iom; 

import  java . lang . ref lect . * ; 
import  java . beans . * ; 
import  java . util . List ; 
import  java . util . ArrayList ; 

import  org . exolab . castor . mapping . * ; 
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import  org . exolab . castor . xml . * ; 


/** 

*  Helper  class  for  Castor  related  operations. 
*/ 

public  class  CastorHelper  { 

/** 

*  Not  instantiable . 

*/ 

private  CastorHelper ( )  { 

} 


/** 

*  Builds  an  array  of  Attribute  objects  based  on  the  specified  Class. 

*  <br> 

*  The  specified  Class  should  be  generated  by  Castor  from  an  XML  schema. 

*  Only  subclasses  of  FCRInstance  or  CCRInstance  will  be  expanded  with 

*  sub-attributes, 

*  but  indexed  property  whose  element  is  a  subclass  of 

*  FCRInstance  or  CCRInstance  will  NOT  be  expanded. 

*  <br> 

*  To  add  the  elements  in  the  array  returned  to  a  Schema  object,  just  call 

*  Schema . addAttribute ( )  for  each  element. 

*/ 


public  static  Attribute []  classAttributes ( 

FIOMFactory  factory, 

XMLC1 as sDe script or  c 1 as sDe script or 
)  throws  ClassNotFoundException, 
IllegalAccessException, 
InstantiationException  { 

return  classAttributes (  factory,  classDescriptor,  null  ) ; 

} 


/** 

*  Returns  an  array  of  Attribute  instances,  with  the  specified  Attribute,  parent, 

*  as  the  parent . 

*/ 

public  static  Attribute []  classAttributes (  FIOMFactory  factory, 

XMLC 1 as sDe script or  classDescriptor, 

Attribute  parent  ) 

throws  ClassNotFoundException, 
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IllegalAccessException, 
InstantiationException  { 

XMLFieldDescriptor [ ]  fieldDescs  =  classDescriptor . getElementDescriptors ( ) ; 

if  (f ieldDescs==null) 

return  new  Attribute [ 0 ]  ; 

Attribute []  result  =  new  Attribute [ fieldDescs . length]  ; 

XMLFieldDescriptor  field; 

FieldValidator  validator; 

Class  fieldType; 

TypeName  typeName; 

for  (int  i=0;  i<result . length;  i++)  { 

field  =  fieldDescs [i] ; 
validator  =  field. getValidator () ; 
fieldType  =  field. getFieldType () ; 
if  (field. isMultivalued () )  { 

typeName  =  factory .makeArrayTypeName ( 
fieldType, 

1  )  ; 


else  { 

typeName  =  factory .makeTypeName (fieldType) ; 

} 

result [i]  =  factory .makeAttribute (  parent,  decapitalize (field. getXMLName ()) ,  typeName  ) 

result [ i ]. setMinOccurs (  validator . getMinOccurs ( )  ); 
result [i] . setMaxOccurs (  validator . getMaxOccurs ( )  ); 

//p(i  +  "  AttrName:  "  +  result [i] . getName ()) ; 

if  (  FCRInstance . class . isAssignableFrom (fieldType) 

| |  CCRInstance . class . isAssignableFrom (fieldType)  )  { 

Class  c  =  Class . forName (fieldType . getName () +"Descriptor" ) ; 

XMLClassDescriptor  classDesc  =  (XMLClassDescriptor )  c . newlnstance ( ) ; 
classAttributes (  factory, 

classDesc, 
result [ i ]  )  ; 


return  result; 

} 


/** 

*  Decapitalize  the  first  character,  unless  the  2nd  character  is  also  in  uppercase. 
*/ 

public  static  String  decapitalize (  String  s  )  { 


70 


if  (s . length () ==0) 
return  s; 
else  { 

if  (s  .  length  ()  >1) 

if  (s . charAt (1) ==Character . toUpperCase (s . charAt (1 ) ) ) 
return  s; 
else 

return  Character . toLowerCase (s . charAt (0) )  +  s . substring ( 1 ) ; 

else 

return  s . toLowerCase  () ; 

} 

} 

/** 

*  Build  up  the  Attribute  tree  for  the  specified  PropertyDescriptor . 

*  Only  subclasses  of  FCRInstance  or  CCRInstance  will  be  expanded  with 

*  sub-attributes. 

*  An  indexed  property  whose  element  is  a  subclass  of 

*  FCRInstance  or  CCRInstance  will  NOT  be  expanded. 

*/ 

public  static  Attribute  propertyToAttribute ( 

FIOMFactory  factory. 

Attribute  parent, 

PropertyDescriptor  desc  ) 
throws  IntrospectionException  { 

TypeName  typeName; 

Class  descType; 

if  (desc  instanceof  IndexedPropertyDescriptor)  { 

descType  =  (( IndexedPropertyDescriptor) desc) . getlndexedPropertyType ( ) ; 
typeName  =  factory .makeArrayTypeName ( 
descType, 

1  )  ; 

} 

else  { 

descType  =  desc . getPropertyType ( ) ; 
typeName  =  factory .makeTypeName (descType) ; 

} 

Attribute  result  =  factory .makeAttribute (  parent,  desc . getName ( ) ,  typeName  ); 
if  (  FCRInstance . class . isAssignableFrom (descType) 

||  CCRInstance . class . isAssignableFrom (descType)  )  { 

PropertyDescriptor [ ]  childs  =  castorClassProperties (  descType  ); 
for  (int  i=0;  icchilds . length;  i++)  { 

propertyToAttribute (  factory,  result,  childs [i]  ); 

} 
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return  result; 


/** 

*  Returns  an  array  of  PropertyDescriptor  for 

*  the  specified  class. 

*  The  properties  "valid"  (Castor  specific  property) 

*  and  "class"  (property  common  to  all  classes)  are  not  returned. 

*/ 

public  static  PropertyDescriptor [ ]  castorClassProperties (  Class  aClass  ) 

throws  IntrospectionException  { 

return  classProperties (  aClass,  new  String []  {"class",  "valid"}  ); 


/** 

*  Returns  an  array  of  PropertyDescriptor  for 

*  the  specified  class. 

*  Properties  with  names  found  in  namesToIgnore  are  not  included  in  the 

*  array  returned. 

*/ 

public  static  PropertyDescriptor [ ]  classProperties (  Class  aClass,  String []  namesToIgnore  ) 

throws  IntrospectionException  { 

Beanlnfo  beanlnfo  =  java . beans . Introspector . getBeanlnfo (aClass ) ; 

PropertyDescriptor [ ]  propDescs  =  beanlnfo . getPropertyDescriptors () ; 

List  result  =  new  ArrayList (propDescs . length-1 ) ; 

String  attrName; 
boolean  ignore; 

for  (int  i=0;  i<propDescs . length;  i++)  { 

attrName  =  propDescs [i] . getName () ; 
ignore  =  false; 

for  (int  j=0;  j<namesToIgnore . length;  j++)  { 

if  (attrName . equals (namesToIgnore [ j ] ) ) 
ignore  =  true; 

}  //  for 
if  (  ! ignore) 

result . add (propDescs [ i ]  )  ; 

} 

return  (PropertyDescriptor}])  result . toArray (  new  PropertyDescriptor [ result . size ()  ]  ); 


public  static  void  p (String  msg)  { 
System. out . print In (msg) ; 

} 
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5, 


CCR.java 


package  mil . navy . nps . cs . oomi . f iom; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


/** 

*  Represents  a  CCR  in  OOMI. 

*  A  CCR  should  be  uniquely  defined  by: 

*  <ol> 

*  <li>  SystemName  and  CCRName 

*  <li>  SystemName  and  XMLNameSpaceURI 

*  </ ol> 

*  within  the  FIOM. 

*  <p> 

*  Responsibilities: 

*  <ul> 

*  <li>  Represents  a  CCR  in  the  OOMI  FIOM. 

*  <li>  Maintain  information  on  whether  an  attribute  of  its  FCR  is  mandatory, 

*  based  on  the  FCRtoCCR  attribute  mappings  contained  in  this  object. 

*  </ul> 

*  @author  LSC 

*  ©version  1.0 
*/ 

public  interface  CCR  { 

/** 

*  Returns  the  name  of  this  CCR. 

*/ 

public  String  getCCRName ( ) ; 

/** 

*  Returns  the  name  of  the  system  this  CCR  is  defined  for. 

*/ 

public  String  getSystemName ( ) ; 
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/** 

*  Returns  the  FCR  of  this  CCR. 

*/ 

public  FCR  getFCR ( )  ; 

/** 

*  Joins  this  CCR  to  the  specified  FCR. 

*  If  bewFCR==null,  nothing  is  done. 

*  @param  newFCR  The  FCR  that  this  CCR  will  be  joining. 

*/ 

public  void  joinFCR(  FCR  newFCR  )  ; 

/** 

*  Returns  the  CCRSchema  for  this  object. 

*/ 

public  CCRSchema  getCCRSchema ( ) ; 

/** 

*  Returns  the  fully-qualified  Castor 

*  generated  Java  class's  (a  descendent  of  CCRInstance)  name  for  this  CCR. 

*  A  String  is  used  instead  of  Class  so  that  it  may  be  possible 

*  to  work  with  the  CCR  without  actually  loading  the  bytecode  for  the 

*  class. 

*/ 

public  String  get JavaClassName ( ) ; 

/** 

*  Sets  the  fully-qualified  name  of  the  Castor 

*  generated  Java  class  (a  descendent  of  CCRInstance)  for  this  CCR. 

*/ 

public  void  set JavaClassName (  String  javaClassName  ) ; 

/** 

*  Returns  the  XML  Schema  URI  this  CCR  is  defined  for. 

*/ 

public  String  getXMLNameSpaceURI ( )  ; 

/** 

*  Sets  the  XML  Schema  URI  this  CCR  is  defined  for. 

*  A  well-formed  valid  URI  is  expected,  no  error  checking  is  performed. 

*/ 

public  void  setXMLNameSpaceURI (  String  xmlNameSpaceURI  ) ; 
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/** 

*  The  given  FCR  attribute  is  mandatory  if  it  is  mapped  to  one  or  more  mandatory 

*  CCR  attributes. 

*/ 

public  boolean  isMandatoryFCRAttribute (  Attribute  fcrAttr  ) ; 

/** 

*  Returns  an  array  of  mandatory  attributes  of  the  FCR  this  CCR  is  associated 

*  with. 

*/ 

public  Attribute!]  mandatoryFCRAttributes ( )  ; 

/** 

*  Returns  the  number  of  mandatory  attributes  of  the  FCR  this  CCR  is  associated 

*  with. 

*/ 

public  int  mandatoryFCRAttributeCount ( )  ; 

/** 

*  Adds  a  mapping  of  FCR  attributes  to  the  attribute  of  this  CCR  object. 

*/ 

public  void  addFCRToCCRAttributeMapping (  Attribute!]  from.  Attribute  to  ); 

/** 

*  Clears  the  FCR  to  CCR  attribute  mappings. 

*/ 

public  void  clearFCRToCCRAttributeMappings ( )  ; 


6.  CCRInstance.java 

package  mil . navy . nps . cs . oomi . f iom; 


import  java . io . Input Stream; 
import  java . io . InputStreamReader; 
import  java . io . OutputStream; 
import  java . io . OutputStreamWriter; 

import  org . exolab . castor . xml . * ; 

import  org . exolab . castor . xml .MarshalException; 
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import  org . exolab . castor . xml . ValidationException; 


import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  Base  class  for  all  marshalled  CCR  Instances,  it  abstracts  the  marshalling 

*  and  unmarshalling  to/from  XML,  all  Castor  generated  classes  from  the 

*  component  systems'  schemas  should  use  this  class  as  their  base  class. 

*  <br/> 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

abstract  public  class  CCRInstance  { 

/** 


*/ 


public  static  CCRInstance  unmarshal (Class  theClass,  java . io . InputStream  inStream) 

throws  UnmarshalException  { 


try  { 

return  (CCRInstance) 


Unmarshaller . unmarshal ( 

theClass, 

new  InputStreamReader (inStream) 


) ; 


catch  (Exception  exc)  { 

throw  new  UnmarshalException (  exc . getClass ( ) . getName ( )  +  ":  "  +  exc . getMessage ( )  ) 


public  void  marshal ( java . io . OutputStream  outStream) 

throws  ValidationException, 
MarshalException  { 

Marshaller .marshal (this,  new  OutputStreamWriter (outStream) ) ; 


7.  CCRSchema.java 

package  mil . navy . nps . cs . oomi . f iom; 

/** 

*  @author  LSC 

*  ©version  1 . 0 
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/ 


public  interface  CCRSchema  extends  Schema  { 


8.  CCRSemantics.java 

package  mil . navy . nps . cs . oomi . f iom; 

/** 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  interface  CCRSemantics  { 


9.  CCRSyntax.java 

package  mil . navy . nps . cs . oomi . f iom; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  interface  CCRSyntax  { 


10.  FCR.java 

package  mil . navy . nps . cs . oomi . f iom; 

import  java . net . URL; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


I  ★  ★ 


*  @author  LSC 
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(Aversion  1 . 0 


*/ 

public  interface  FCR  { 

/** 

*  Returns  the  name  of  this  FCR. 

*/ 

public  String  getFCRName ( ) ; 

/** 

*  Returns  the  FEV  of  this  FCR. 

*/ 

public  FEV  getFEVO; 

/** 

*  Returns  the  number  of  CCRs  defined  for  this  FCR. 

*/ 

public  int  ccrCount () ; 

/** 

*  Returns  all  the  CCRs  defined  for  this  FCR  in  an  array. 

*  ©return  Returns  all  the  CCRs  defined  for  this  FCR  in  an  array, 

*  an  empty  array  is  returned  if  no  CCRs  defined. 

*/ 

public  CCR[]  getCCRO; 


/** 

*  Finds  all  the  CCRs  which  satisifies  the  specified  criteria. 

*  ©param  criteria 
*/ 

public  void  f indCCR (SearchHandler  handler); 

/** 

*  Finds  all  the  CCR  with  for  the  specified  system. 

*  ©param  systemName 

*  ©return  Returns  all  the  CCRs  in  this  FCR  that  belongs  to  the  specified  system  name 

*  (not  case-sensitive) . 

*  Returns  an  empty  array  if  not  found. 

*/ 

public  CCR [ ]  f indCCR (  String  systemName  ); 
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/** 

*  Finds  the  CCR  with  the  specified  name. 

*  @param  systemName 

*  @param  ccrName 

*  ©return  Returns  the  CCR  in  this  FCR  that  has  the  specified  name 

*  (not  case-sensitive) . 

*  Returns  null  if  not  found. 

*/ 

public  CCR  findCCR(  String  systemName,  String  ccrName  ); 

/** 

*  Finds  the  CCR  with  the  specified  system  name  and  xmlNameSpaceURI . 

*  ©param  systemName 

*  ©param  xmlNameSpaceURI 

*  ©return  Returns  the  CCR  in  this  FCR  that  has  the  specified  system  name 

*  (not  case-sensitive)  and  xmlNameSpaceURI. 

*  Returns  null  if  not  found. 

*  xmlNameSpaceURI==null  shall  always  result  in  a  return  value  of  null. 
*/ 

public  CCR  findCCR(  String  systemName,  URL  xmlNameSpaceURI  ); 

/** 

*  Returns  true  if  this  FCR  has  a  CCR  with  specified  name. 

*/ 

public  boolean  ccrExists (String  systemName,  String  ccrName) ; 

/** 

*  Returns  true  if  this  FCR  has  a  CCR  with  specified  name. 

*  ©return  Returns  true  if  this  FCR  has  a  CCR  with  specified  name. 

*  Returns  false  if  xmlNameSpaceURI==null . 

*/ 

public  boolean  ccrExists (String  systemName,  URL  xmlNameSpaceURI); 


/** 

*  Creates  a  new  instance  of  CCR  for  this  FCR  and  returns  the  newly  created 

*  instance. 

*  ©param  systemName  The  system  name. 

*  ©param  ccrName  The  name  of  the  new  CCR. 

*  ©param  xmlNameSpaceURI  The  URL  to  the  XML  schema  that  the  new  CCR  represents. 

*  Pass  in  null  if  XML  schema  is  not  required. 
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*  ©throws  DuplicateKeyExcept ion  When  the  specified  systemName, ccrName  pair  or 

*  systemName,  xmlNameSpaceURI  pair 

*  already  exist  for  this  FCR. 

*/ 

public  CCR  newCCR (String  systemName,  String  ccrName,  URL  xmlNameSpaceURI) 

throws  DuplicateKeyException; 


/** 

*  Returns  the  FCRSchema  for  this  object. 

*/ 

public  FCRSchema  getFCRSchema ( ) ; 

/** 

*  Returns  the  Java  class  name  for  this  FCR. 

*/ 

public  String  get JavaClassName  () ; 

/** 

*  Sets  the  Java  class  name  for  this  FCR. 

*/ 

public  void  set JavaClassName (String  className) ; 

/** 

*  Finds  the  CCR  that  represents  the  specified  XML  schema. 

*  A  case-sensitive  comparison  is  performed. 

*  ©param  xmlNameSpaceURI  The  URL  to  the  XML  schema  whose  corresponding  CCR 

*  is  to  be  found. 

*  ©return  Returns  the  CCR  that  represents  the  specified  XML  schema 

*  corresponding  to  this  FCR. 

*  Returns  null  if  no  such  CCR  exists  or  if  xmlNameSpaceURI==null . 
*/ 

//  public  CCR  findCCR(  URL  xmlNameSpaceURI  ); 


11.  FCRInstance.java 

package  mil . navy . nps . cs . oomi . f iom; 
/** 

*  Base  class  for  all  FCR  Instances. 

*  <br/> 
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*  @author  LSC 

*  ©version  1 . 0 
*/ 

public  class  FCRInstance  { 
public  FCRInstance ( )  { 

} 

} 

12.  FCRInstanceHelper.java 

package  mil . navy . nps . cs . oomi . f iom; 

import  java. util.*; 

import  java . lang . ref lect .* ; 

import  java . beans .* ; 

import  java . lang . ref . Sof tRef erence ; 

/** 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  class  FCRInstanceHelper  { 

protected  FCRInstanceHelper ( )  { 

} 

/** 

*  Clones  srcObj, 

*  returning  a  new  FCRInstance  object  of  type  dstClass, 

*  only  shallow  copy  is  performed  for  all  properties  found  in  both  dstClass 

*  and  srcObj . 

*/ 

public  static  FCRInstance  clone  (  FCRInstance  srcObj,  Class  dstClass  ) 

throws  IntrospectionException, 
IllegalAccessException, 

Inst ant iationExcept ion, 

I nvocationTarget Except ion, 
NoSuchMethodException  { 

PropertyDescriptor [ ]  srcPropDescs  =  classProperties (srcObj . getClass ()) ; 
HashMap  srcPropMap  =  toHashMap (srcPropDescs) ; 

PropertyDescriptor [ ]  dstPropDescs  =  classProperties (dstClass) ; 

HashMap  dstPropMap  =  toHashMap (dstPropDescs ) ; 
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FCRInstance  result  =  (FCRInstance) dstClass . newlnstance ( ) ; 

PropertyDescriptor  dstDesc; 

PropertyDescriptor  srcDesc; 

String  propName; 

for  (int  i=0;  i<srcPropDescs . length;  i++)  { 

srcDesc  =  srcPropDescs [ i ]  ; 
propName  =  srcDesc . getName () ; 

dstDesc  =  (PropertyDescriptor)  dstPropMap . get (propName) ; 
if  (dstDesc ! =null) 

if  (  hasValue (  srcObj,  propName  )  ) 

//  write  the  value  only  if  the  has<PropertyName>  value  in  srcObj  is  true 
writeValue (  dstDesc,  result,  readValue (srcDesc,  srcObj)  ); 

} 

return  result; 


/** 

*  Clones  srcObj, 

*  returning  a  new  FCRInstance  object  of  type  dstClass, 

*  only  shallow  copy  is  performed  for  all  properties  found  in  both  dstClass 

*  and  srcObj . 

*/ 

public  static  FCRInstance  clonel (  FCRInstance  srcObj,  Class  dstClass  ) 

throws  IntrospectionException, 
IllegalAccessException, 
InstantiationException, 
InvocationTargetException  { 

PropertyDescriptor [ ]  srcPropDescs  =  classProperties (srcObj . getClass ()) ; 

HashMap  srcPropMap  =  toHashMap (srcPropDescs) ; 

PropertyDescriptor [ ]  dstPropDescs  =  classProperties (dstClass ) ; 

HashMap  dstPropMap  =  toHashMap (dstPropDescs ) ; 

FCRInstance  result  =  (FCRInstance) dstClass . newlnstance () ; 

PropertyDescriptor  dstDesc; 

PropertyDescriptor  srcDesc; 

String  propName; 

for  (int  i=0;  i<srcPropDescs . length;  i++)  { 

srcDesc  =  srcPropDescs [ i ]  ; 
propName  =  srcDesc . getName () ; 

dstDesc  =  (PropertyDescriptor)  dstPropMap . get (propName) ; 
if  (dstDesc ! =null) 

if  (  hasValue (  srcObj,  srcPropMap,  srcDesc  )  ) 

//  write  the  value  only  if  the  has<PropertyName>  value  in  srcObj  is  true 
writeValue (  dstDesc,  result,  readValue (srcDesc,  srcObj)  ); 
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return  result; 


/** 

*  Writes  the  property  value  for  the  specified  object  into  the  property  described 

*  by  the  specified  PropertyDescriptor . 

*  <br> 

*  If  the  property  is  readonly,  that  is,  no  setter  method  for  the  specified 

*  PropertyDescriptor  exists,  nothing  is  done. 

*  @param  desc  The  PropertyDescriptor  for  the  object  whose  property  is  be  changed. 

*  @param  obj  The  object  whose  property  is  to  be  changed. 

*  ©param  value  The  new  value  of  the  property. 

*/ 

static  void  writeValue (  PropertyDescriptor  desc.  Object  obj.  Object  value  ) 

throws  I nvocationTarget Except ion, 
IllegalAccessException  { 

Method  writeMethod  =  desc . getWriteMethod ( ) ; 

//  if  property  is  readonly,  do  nothing, 
if  (writeMethod ! =null)  { 

Object []  args  =  {  value  }; 
writeMethod . invoke (  obj,  args  ); 


/** 

*  Reads  the  property  value  for  the  specified  object  into  the  property  described 

*  by  the  specified  PropertyDescriptor. 

*  @param  desc  The  PropertyDescriptor  for  the  object  whose  property  is  be  read. 

*  ©param  obj  The  object  whose  property  is  to  be  read. 

*  ©return  Returns  the  value  of  the  specified  object's  specified  property's  value. 
*/ 

static  Object  readValue (  PropertyDescriptor  desc.  Object  obj  ) 

throws  I nvocationTarget Except ion, 
IllegalAccessException  { 

Method  readMethod  =  desc . getReadMethod ( ) ; 

Object []  args  =  {}; 

return  readMethod. invoke (  obj,  args  ); 


/** 

*  Returns  an  array  of  PropertyDescriptor  for 

*  the  specified  class  of  FCRInstance,  the  getClassO  method  present  in  all 

*  objects  is  ignored. 

*/ 
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static  PropertyDescriptor [ ]  classProperties  (  Class  aClass  ) 

throws  IntrospectionException  { 

Beanlnfo  beanlnfo  =  Introspector . getBeanlnfo (aClass)  ; 

PropertyDescriptor [ ]  propDescs  =  beanlnfo . getPropertyDescriptors () ; 

List  result  =  new  ArrayList (propDescs . length-1 ) ; 

String  attrName; 

for  (int  i=0;  i<propDescs . length;  i++)  { 

attrName  =  propDescs [ i ]. getName () ; 
if  (attrName . equals ( "class"  )  ) 
continue; 

/ /p (  attrName  +  "  "  +  propDescs [ i ]. getPropertyType (). getName ()) ; 

result . add (propDescs [ i ] )  ; 

} 

return  (PropertyDescriptor [] )  result . toArray (  new  PropertyDescriptor [ result . size () ]  ) 


/** 

*  Returns  an  array  of  property  names  for  the  specified  FCRInstance. 
*/ 

public  static  String []  extractAttributeNames (  FCRInstance  obj  ) 

throws  IntrospectionException  { 
PropertyDescriptor [ ]  descs  =  classProperties (obj . getClass ()) ; 
String []  result  =  new  String [descs . length] ; 
for  (int  i=0;  i<descs . length;  i++)  { 

result [i]  =  descs [ i ]. getName () ; 

} 

return  result; 


/** 

*  Creates  a  PropertyDescriptor  HashMap  using  the  Property  name  as  the  key. 
*/ 

static  HashMap  toHashMap (  PropertyDescriptor [ ]  descs  )  { 

HashMap  map  =  new  HashMap ( ) ; 

for  (int  i=0;  i<descs . length;  i++)  { 

map. put (  descs [i] . getName () ,  descs [i]  ); 

} 

return  map; 


/** 

*  Capitalizes  the  first  character  of  the  specified  string. 
*/ 

static  String  capitalize (String  s)  { 
if  (s==null)  return  null; 
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if  (s  .  length  ()  >0) 

return  Character .toUpperCase (s .charAt (0) )  +  s.substring(  1,  s. length ()  ); 

else 

return  s; 


/** 

*  A  HashMap  to  cache  PropertyDescriptor  arrays. 

*/ 

static  Map  _propDescArrayMap  =  new  WeakHashMap ( ) ; 

static  Map  _propDescMap  =  new  WeakHashMap () ; 

/** 

*  Returns  an  instance  of  PropertyDescriptor [ ]  for  the  specified  Object, 

*  uses  _propDescArrayMap  if  possible. 

*  If  the  required  array  is  not  found  in  the  map,  the  array 

*  is  created  and  added  to  the  map. 

*  @param  obj 

*  @param  attr 

*  @return  An  array  of  PropertyDescriptor  for  the  specified  Object. 

*/ 

static  PropertyDescriptor  [  ]  propertyDescriptorArray (Ob ject  obj) 

throws  IntrospectionException  { 

String  key  =  ob j . getClass ( ) . getName ( ) ; 

PropertyDescriptor [ ]  result  =  (PropertyDescriptor []) _propDescArrayMap . get (key) 
if  (result==null)  { 

result  =  classProperties (  obj . getClass ( )  ); 

_propDescArrayMap . put (  key,  result  ); 

} 

return  result; 


/** 

*  Returns  an  instance  of  PropertyDescriptor  for  the  specified  Object, 

*  uses  _propDescMap  if  possible. 

*  If  the  required  array  is  not  found  in  the  map,  the  array 

*  is  created  and  added  to  the  map. 

*  @param  obj 

*  @param  propertyName 

*  @return  A  PropertyDescriptor  of  the  property  with  the  specified  name 

*  of  the  specified  Object. 

*/ 
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static  PropertyDescriptor  propertyDescriptor (  Object  obj. 

String  propertyName) 
throws  IntrospectionException  { 
String  key  =  ob j . getClass  ( )  . getName ( )  +  +  propertyName; 

PropertyDescriptor  result  =  (PropertyDescriptor) _propDescMap . get (key ) ; 
if  (result==null)  { 

PropertyDescriptor [ ]  descArray  =  propertyDescriptorArray (ob j ) ; 
PropertyDescriptor  desc; 

for  (int  i=0;  i<descArray . length;  i++)  { 

desc  =  descArray [ i ]  ; 

if  (propertyName . equals (desc . getName ( ) ) ) 
result  =  desc; 

//  cache  all  descriptors,  since  it  is  expected  that  all  descriptors  for 
//  the  object  will  be  required  in  the  near  future 
_propDescMap . put (  key,  result  ); 


return  result; 

} 


/** 

*  Finds  the  descriptor  in  the  specified  PropertyDescriptor  array  with  the 

*  name  as  specified  in  the  parameter  name. 


*/ 

//static  PropertyDescriptor  f indDescriptor (  PropertyDescriptor 

/** 


*/ 

public  static  Method  hasserMethod (  Class  els.  String  fieldName  ) 

throws  NoSuchMethodException { 

String  methodName  =  "has"  +  capitalize (fieldName) ; 
return  els . getMethod (  methodName,  null  ); 


/** 

*  If  the  specified  Object  does  not  have  a  "has"  method  for  the  specified 

*  fieldname,  a  true  value  is  returned. 

*/ 

public  static  boolean  hasValue (  Object  obj.  String  fieldName  ) 

throws  NoSuchMethodException, 

I nvocationTar get Except ion, 
IllegalAccessException  { 
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try  { 


Object  result  =  hasserMethod (  ob j . getClass ( ) ,  fieldName  ). invoke (  obj,  null  ); 
return  (  (Boolean) result)  . booleanValue () ; 

} 

catch  (NoSuchMethodException  e)  { 
return  true; 


/** 

*  Indicates  if  the  field  refered  to  by  the  specified  Attribute 

*  of  the  specified  FCRInstance  has  a  value  set. 

*  @param  object 

*  @param  attr 

*  ©return  true  if  the  specified  Attribute's  value  had  been  set, 

*  false  if  the  Attribute  value  had  not  been  set. 

*/ 

public  static  boolean  hasValue (  FCRInstance  object.  Attribute  attr  ) 

throws  I nvocationTar get Except ion, 

IllegalAccessException, 

NoSuchMethodException, 

IntrospectionException  { 

Attribute []  path  =  attr . pathToArray ( ) ; 

FCRInstance  currObj  =  object; 

Attribute  curr; 

String  currPropertyName; 
boolean  hasValue  =  false; 
for  (int  i=0;  i<path . length;  i++)  { 

curr  =  path  [  i ] ; 

currPropertyName  =  curr . getName ( ) ; 

hasValue  =  hasValue (  currObj,  currPropertyName  ); 
if  ( ! hasValue) 

//  if  any  ancestor  does  not  have  a  value,  then  the  attribute 
//  should  not  have  a  value  as  well 
return  false; 
if  (i<path. length-1) 

//  last  attribute 

currObj  =  (FCRInstance)  readValue (  propertyDescriptor (currObj ,  currPropertyName), 

currObj  ) ; 


return  hasValue; 

} 
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*  Indicates  if  the  property  refered  to  by  the  specified  Attribute 

*  of  the  specified  FCRInstance  has  a  value  set. 

*  @param  object 

*  @param  attr 

*  ©return  A  PropertyDescriptor  instance  for  the  specified  Attribute  of  the 

*  specified  FCRInstance. 

*/ 

public  static  boolean  hasPropertyValue (  FCRInstance  object.  Attribute  attr  ) 

throws  I nvocationTarget Except ion, 

IllegalAccessException, 

IntrospectionException  { 

Attribute []  path  =  attr . pathToArray ( ) ; 

FCRInstance  currObj  =  object; 

Attribute  curr; 

String  currPropertyName; 
boolean  hasValue  =  false; 
for  (int  i=0;  i<path . length;  i++)  { 

curr  =  path [ i ] ; 

currPropertyName  =  curr . getName ( ) ; 

hasValue  =  hasPropertyValue (  currObj,  currPropertyName  ); 
if  ( ! hasValue) 

//  if  any  ancestor  does  not  have  a  value,  then  the  attribute 
//  should  not  have  a  value  as  well 
return  false; 
if  (i<path. length-1) 

//  last  attribute 

currObj  =  (FCRInstance)  readValue (  propertyDescriptor (currObj ,  currPropertyName), 

currObj  ) ; 


return  hasValue; 

} 


/** 

*  Indicates  whether  a  property  with  the  specified  propertyName 

*  has  a  value  set,  by  inspecting 

*  the  boolean  value  of  the  has<PropertyName>  property  in  propDescs. 

*  If  no  such  method  is  found  for  the  property,  a  true  value  is  returned. 

*  ©param  obj 

*  ©param  propDesc 

*  ©param  propertyName 

*  ©return  True  if  the  property  of  the  specified  Object  parameter’s  specified 

*  PropertyDescriptor  parameter  has  a  value  set. 
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*/ 

static  boolean  hasPropertyValue (  Object  obj,  String  propertyName  ) 

throws  IllegalAccessException, 

I nvocationTarget Except ion, 
IntrospectionException  { 

String  hasPropertyName  =  "has"  +  capitalize (  propertyName  ); 

P rope rtyDe script or  hasPropertyDesc 

=  (PropertyDescriptor )  propertyDescriptor (ob j ,  hasPropertyName); 
if  (hasPropertyDesc ! =null)  { 

Class  hasPropertyType  =  hasPropertyDesc . getPropertyType () ; 
if  (hasPropertyType==Boolean . TYPE)  { 

return  ((Boolean)  readValue (  hasPropertyDesc,  obj  )) .booleanValue () ; 


return  true; 

} 


/** 

*  Indicates  whether  the  specified  property  has  a  value  set,  by  inspecting 

*  the  boolean  value  of  the  has<PropertyName>  property  in  propDescs. 

*  If  no  such  method  is  found  for  the  property,  a  true  value  is  returned. 

*  @param  obj 

*  @param  propDescs 

*  @param  property 

*  ©return  True  if  the  property  of  the  specified  Object  parameter's  specified 

*  PropertyDescriptor  parameter  has  a  value  set. 


*/ 

static  boolean  hasValue (  Object  obj,  HashMap  propDescs,  PropertyDescriptor  property  ) 

throws  IllegalAccessException, 

InvocationTargetException  { 

String  hasPropertyName  =  "has"  +  capitalize (  property . getName ( )  ); 

PropertyDescriptor  hasPropertyDesc  =  (PropertyDescriptor)  propDescs . get (hasPropertyName) 
if  (hasPropertyDesc ! =null)  { 

Class  hasPropertyType  =  hasPropertyDesc . getPropertyType () ; 
if  (hasPropertyType==Boolean . TYPE)  { 

return  ((Boolean)  readValue (  hasPropertyDesc,  obj  )) .booleanValue () ; 


return  true; 

} 
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public  static  void  p (String  msg)  { 
System. out . print In (msg) ; 

} 


13.  FCRSchema.java 

package  mil . navy . nps . cs . oomi . f iom; 

/** 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  interface  FCRSchema  extends  Schema  { 


14.  FCRSemantics.java 

package  mil . navy . nps . cs . oomi . f iom; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  interface  FCRSemantics  { 


15.  FCRSyntax.java 

package  mil . navy . nps . cs . oomi . f iom; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  interface  FCRSyntax  { 
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16.  FE.java 


package  mil . navy . nps . cs . oomi . f iom; 

import  java . net . URL; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  The  OOMI  Federation  Entity. 

*  @author  LSC 

*  ©version  1 . 0 
*/ 

public  interface  FE  { 

/** 

*  Returns  the  FIOM  that  this  FE  belongs  to. 

*  ©return  Returns  the  FIOM  that  this  FE  belongs  to. 

*/ 

public  FIOM  getFIOM ( ) ; 

/** 

*  Returns  the  name  of  this  FE . 

*/ 

public  String  getFEName(); 

/** 

*  Returns  the  parent  of  this  FE . 

*  ©return  Returns  the  parent  of  this  FE,  returns  null  if  this  FE  has  no 

*  parent . 

*/ 

public  FE  getParentO; 

/** 
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Returns  the  root  FEV  of  this  FE . 


*  Automatically  creates  a  new  root  FEV  if  one  does  not  already  exists. 

*  @return  Returns  the  root  FEV  of  this  FE . 

*/ 

public  FEV  getRootFEV ( ) ; 

/** 

*  Finds  the  FEV  with  the  specified  name. 

*  @return  Returns  the  FEV  in  this  FE  that  has  the  specified  name 

*  (not  case-sensitive) . 

*  Returns  null  if  not  found. 

*/ 

public  FEV  findFEV(  String  fevName  ); 

/** 

*  Determines  if  there  is  a  FEV  with  the  specified  name  for  this  FE . 

*/ 

public  boolean  fevExists (String  fevName) ; 

/** 

*  Creates  a  new  instance  of  FEV  with  the  specified  name, 

*  replaces  the  current  root  FEV. 

*/ 

public  FEV  createRootFEV (String  fevName); 

/** 

*  Create  a  new  child  FE  for  this  FE  and  returns  the  newly  created  child. 

*  @return  Returns  the  newly  created  child  FE . 

*/ 

public  FE  newChild (String  childFEName)  throws  DuplicateKeyException; 


/** 

*  Returns  the  number  of  child  FEs  of  this  object. 

*  @return  Returns  the  number  of  child  FEs  of  this  object. 
*/ 

public  int  childCount ( ) ; 


Returns  an  array  of  child  FEs  of  this  FE . 

@return  Returns  an  array  of  child  FEs  of  this  FE,  returns  an  empty  array 
if  there  are  no  children. 
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*/ 

public  FE [ ]  getChild ( ) ; 

/** 

*  Finds  a  descendent  FE  with  the  specified  name. 

*  @param  descendentName  The  name  of  the  descendent  to  find. 

*  @param  recurseTree  Whether  to  search  in  subtrees. 

*  ©return  Returns  a  descendent  FE  with  the  specified  name,  returns  null 

*  if  not  found. 

*/ 

public  FE  f indDescendent (String  descendentName,  boolean  recurseTree) ; 


/** 

*  Finds  and  returns  all  CCRs  within  the  hierarchy  (including  this  FE) 

*  using  the  specified  SearchHandler . 

*  ©param  handler  The  SearchHandler  to  use  during  search. 

*/ 

public  void  findCCR (SearchHandler  handler); 

/** 

*  Finds  and  returns  all  CCRs  within  the  hierarchy 

*  (only  the  descendents  of  this  FE,  excluding  this  FE) 

*  using  the  specified  SearchHandler. 

*  ©param  handler  The  SearchHandler  to  use  during  search. 

*/ 

public  void  f indDescendentCCR (SearchHandler  handler); 


/** 

*  Finds  and  returns  the  all  CCRs  within  the  hierarchy  (including  this  FE) 

*  with  SystemName  matching  specified  systemName. 

*  ©param  systemName  The  system  name  to  match. 

*  ©return  Returns  an  array  of  CCRs  matching  specified  systemName, 

*  returns  an  empty  array  if  no  match  found. 

*/ 

public  CCR[]  findCCR (String  systemName); 

/** 

*  Finds  and  returns  the  CCR  within  the  hierarchy  (including  this  FE) 

*  with  SystemName  and  XMLNameSpaceURI  matching  the 

*  specified  systemName  and  xmlNameSpaceURI . 
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*  @param  systemName  The  system  name  to  match. 

*  @param  xmlNameSpaceURI  The  XML  schema  URL  to  match. 

*  @return  Returns  the  CCR  matching  the 

*  specified  systemName  and  xmlNameSpaceURI, 

*  returns  null  if  no  match  found. 

*/ 

public  CCR  findCCR (String  systemName,  URL  xmlNameSpaceURI); 

/** 

*  Finds  and  returns  the  CCR  within  the  hierarchy  (excluding  this  FE) 

*  with  SystemName  and  XMLNameSpaceURI  matching  the 

*  specified  systemName  and  xmlNameSpaceURI. 

*  @param  systemName  The  system  name  to  match. 

*  @param  xmlNameSpaceURI  The  XML  schema  URL  to  match. 

*  @return  Returns  the  CCR  matching  the 

*  specified  systemName  and  xmlNameSpaceURI, 

*  returns  null  if  no  match  found. 

*/ 

public  CCR  findDescendentCCR (String  systemName,  URL  xmlNameSpaceURI); 


17.  FEV.java 

package  mil . navy . nps . cs . oomi . f iom; 

import  java . net . URL; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


/** 

*  The  OOMI  Federation  Entity  View. 

*  @author  LSC 

*  ©version  1 . 0 
*/ 

public  interface  FEV  { 
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/ 


*  Returns  the  name  of  this  FEV. 

*/ 

public  String  getFEVName ( ) ; 

/** 

*  Returns  the  FE  that  this  FEV  belongs  to. 

*/ 

public  FE  getFE(); 

/** 

*  Returns  the  FCR  corresponding  to  this  FEV. 

*  ©return  Returns  the  FCR  corresponding  to  this  FEV, 

*  if  newFCR ( )  had  not  been  called  before,  returns  null. 

*/ 

public  FCR  getFCR ( ) ; 

/** 

*  Returns  the  parent  of  this  FEV. 

*  ©return  Returns  the  parent  of  this  FEV,  returns  null  if  this  FEV  has  no 

*  parent . 

*/ 

public  FEV  getParentO; 

/** 

*  Creates  a  new  instance  of  FCR  for  this  FEV,  replacing  the  existing  FCR. 

*  ©return  Returns  the  newly  created  instance. 

*/ 

public  FCR  createFCR (String  fcrName) ; 

/** 

*  Returns  an  array  of  child  FEVs  of  this  FEV. 

*  ©return  Returns  an  array  of  child  FEVs  of  this  FEV,  returns  an  empty  array 

*  if  there  are  no  children. 

*/ 

public  FEV [ ]  getChild ( ) ; 

/** 

*  Returns  the  number  of  child  FEVs  of  this  object. 

*  ©return  Returns  the  number  of  child  FEVs  of  this  object. 

*/ 

public  int  childCount ( ) ; 
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/** 

*  Finds  a  descendent  FEV  with  the  specified  name. 

*  @param  descendentName  The  name  of  the  descendent  to  find. 

*  @param  recurseTree  Whether  to  search  in  subtrees. 

*  ©return  Returns  a  descendent  FEV  with  the  specified  name,  returns  null 

*  if  not  found. 

*/ 

public  FEV  f indDescendent (String  descendentName,  boolean  recurseTree) ; 

/** 

*  Finds  and  returns  the  CCR  within  the  hierarchy  (including  this  FEV) 

*  with  SystemName  and  XMLNameSpaceURI  matching  the 

*  specified  systemName  and  xmlNameSpaceURI . 

*  ©param  systemName  The  system  name  to  match. 

*  ©param  xmlNameSpaceURI  The  XML  schema  URL  to  match. 

*  ©return  Returns  the  CCR  matching  the 

*  specified  systemName  and  xmlNameSpaceURI, 

*  returns  null  if  no  match  found. 

*/ 

public  CCR  findCCR (String  systemName,  URL  xmlNameSpaceURI); 

/** 

*  Finds  the  CCRs  within  the  hierarchy  (including  this  FEV) 

*  that  satisfies  the  specified  criteria. 

*  ©param  criteria  The  criteria  to  match. 

*/ 

public  void  findCCR (SearchHandler  handler); 

/** 

*  Finds  and  returns  the  CCR  within  the  sub-tree  (excluding  this  FEV) 

*  with  SystemName  and  XMLNameSpaceURI  matching  the 

*  specified  systemName  and  xmlNameSpaceURI . 

*  ©param  systemName  The  system  name  to  match. 

*  ©param  xmlNameSpaceURI  The  XML  schema  URL  to  match. 

*  ©return  Returns  the  CCR  matching  the 

*  specified  systemName  and  xmlNameSpaceURI, 

*  returns  null  if  no  match  found. 

*/ 

public  CCR  findDescendentCCR (String  systemName,  URL  xmlNameSpaceURI); 
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/** 

*  Create  a  new  child  FEV  for  this  FEV  and  returns  the  newly  created  child. 

*  @return  Returns  the  newly  created  child  FEV. 

*/ 

public  FEV  newChild (String  childFEVName)  throws  DuplicateKeyException; 


18.  FIOM.java 

package  mil . navy . nps . cs . oomi . f iom; 

import  java . net . URL; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


/** 

*  Represents  a  OOMI  Federation. 

*  <p> 

*  <ul> 

*  <li>Under  a  Federation,  a  OCR  shall  always  be  uniquely  identified  by  the 

*  SystemName,  CCRName  pair. 

*  <li>The  OCR  can  also  be  uniquely  identified  by  the  SystemName,  XMLNameSpaceURI 

*  pair,  if  a  XMLNameSpaceURI  had  been  defined  for  the  CCR. 

*  <li>For  the  Federation  to  be  usable  by  the  Translator,  all  CCRs  expected  to 

*  be  received  from  any  system  through  XML  needs  to  have  both 

*  the  values  of  JavaClassName  and  XMLNameSpaceURI  set  appropriately. 

*  </ul> 

*  ©author  LSC 

*  ©version  1.0 
*/ 

public  interface  FIOM  { 

/** 
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Returns  the  name  of  this  FIOM. 


*  @return  Returns  the  name  of  this  FIOM. 

*/ 

public  String  getFIOMName ( )  ; 

/** 

*  Returns  the  FIOMFactory  instance  for  this  FIOM  object. 

*/ 

public  FIOMFactory  factory (); 

/** 

*  Returns  all  FEs  defined  in  this  FIOM  as  an  array. 

*  ©return  Returns  an  array  of  all  FEs  in  this  FIOM. 

*  A  zero-length  array  is  returned  if  there  are  no  FEs  in  this  FIOM. 
*/ 

public  FE [ ]  getFE(); 

/** 

*  Returns  the  number  of  FEs  defined  in  this  FIOM. 

*  ©return  Returns  the  number  of  FEs  defined  in  this  FIOM. 

*/ 

public  int  feCountO; 

/** 

*  Creates  a  new  FE  instance  and  adds  it  to  this  FIOM. 

*  ©param  feName  The  name  of  the  new  FE  to  be  created. 

*  ©return  Returns  the  newly  created  FE  instance. 

*/ 

public  FE  newFE (String  feName)  throws  DuplicateKeyException; 

/** 

*  Finds  and  returns  the  FE  with  the  specified  name  within  this  FIOM. 

*  ©param  feName  The  name  of  the  FE  to  find,  a  case-insensitive  match 

*  is  performed. 

*  ©return  If  there  is  an  FE  with  the  specified  name  is  in  this  FIOM, 

*  the  FE  is  returned,  else  null  is  returned. 

*/ 

public  FE  findFE (String  feName); 


/** 

*  Determines  if  a  FE  with  the  specified  name  exists  in  this  FIOM. 
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*/ 

public  boolean  feExists (String  feName) ; 

/** 

*  Finds  and  returns  the  CCR  within  this  FIOM 

*  with  SystemName  and  XMLNameSpaceURI  matching  the 

*  specified  systemName  and  xmlNameSpaceURI . 

*  @param  systemName  The  system  name  to  match. 

*  @param  xmlNameSpaceURI  The  XML  namespace  URI  to  match. 

*  @return  Returns  the  CCR  matching  the 

*  specified  systemName  and  xmlNameSpaceURI, 

*  returns  null  if  no  match  found. 

*/ 

public  CCR  findCCR (String  systemName,  URL  xmlNameSpaceURI); 


/** 

*  Creates  a  new  CCR  within  this  FIOM  with 

*  systemName,  ccrName,  and  xmlNameSpaceURI  as 

*  specified.  Provides  independent  CCR  creation;  CCR  will  be 

*  associated  with  an  FCR  using  joinFCRO  method  from  class  CCR. 

*  @param  systemName  The  system  name  to  create  CCR  for. 

*  @param  ccrName  The  name  of  the  new  CCR  being  created. 

*  @param  xmlNameSpaceURI  The  XML  namespace  URI  for  the  new  CCR. 

*  ©throws  DuplicateKeyExcept ion  when  the  specified  systemName,  ccrName  pair 

*  or  systemName,  xmlNameSpaceURI  pair  already  exist  for  this  FIOM. 
*/ 

public  CCR  newCCR (String  systemName,  String  ccrName,  URL  xmlNameSpaceURI) 

throws  DuplicateKeyException; 


/** 

*  Registers  the  specified  CCR  with  the  specified  FCR, 

*  removing  the  specified  CCR  from  the  unregistered  list  of  this  FIOM. 

*  The  specified  CCR  must  be  in  the  unregistered  list  of  this  FIOM, 

*  else,  nothing  is  done. 

*/ 

public  void  registerCCR (FCR  fcr,  CCR  ccr)  ; 

/** 

*  Returns  the  number  of  unregistered  CCRs  in  this  FIOM. 

*/ 
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public  int  unregisteredCCRCount ( ) ; 


/** 

*  Adds  newly  created  CCR  to  the  list  of  unregistered  CCRs . 

*  @param  newCCR  The  newly  created  CCR. 

*/ 

public  void  addUnregisteredCCR (  CCR  newCCR  ); 

/** 

*  Returns  an  array  of  all  unregistered  CCR  contained  in  this  FIOM. 

*  @return  Returns  an  array  of  all  unregistered  CCR  contained  in  this  FIOM. 

*/ 

public  CCR[]  getUnregisteredCCR (  ); 

/** 

*  Searches  list  of  unregistered  CCRs  to  see  if  list  contains  CCR  matching  one 

*  specified  by  systemName,  ccrName  pair. 

*  @param  systemName  The  name  of  the  system  the  CCR  was  created  for. 

*  @param  ccrName  The  name  given  to  the  newly  created  CCR. 

*  ©return  Returns  the  CCR  matching  the 

*  specified  systemName  and  ccrName, 

*  returns  null  if  no  match  found. 

*/ 

public  CCR  findUnregisteredCCR (String  systemName,  String  ccrName); 

/** 

*  Searches  list  of  unregistered  CCRs  to  see  if  list  contains  CCR  matching  one 

*  specified  by  systemName,  xmlNameSpaceURI  pair. 

*  ©param  systemName  The  name  of  the  system  the  CCR  was  created  for. 

*  ©param  xmlNameSpaceURI  The  URL  given  to  the  newly  created  CCR. 

*  ©return  Returns  the  CCR  matching  the 

*  specified  systemName  and  xmlNameSpaceURI, 

*  returns  null  if  no  match  found. 

*/ 

public  CCR  findUnregisteredCCR (String  systemName,  URL  xmlNameSpaceURI); 

public  boolean  ccrExists (String  systemName,  String  ccrName) ; 

public  boolean  ccrExists (String  systemName,  URL  xmlNameSpaceURI); 

public  boolean  equals (Object  o) ; 
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*  Adds  a  translation  map  to  this  FIOM. 

*/ 

public  void  addTranslation (  String  f crClassName,  String  ccrClassName, 

String  translationClassName  ) ; 


/** 

*  Finds  the  translation  for  the  specified  fcrClassName  and  ccrClassName. 

*  ©return  Returns  the  fully  qualified  class  name  of  the  translation  class. 

*  Returns  null  if  no  such  translation  exists. 

*/ 

public  String  f indTranslation (  String  fcrClassName,  String  ccrClassName  ); 


/** 

*  Creates  new  instances  of  TypeName. 

*  ©param  typeName  The  type  name  (Java  signature  format) . 

*  ©return  Returns  a  new  instance  of  TypeName  representing  the  type  specified  by  the 
argument  typeName. 

*/ 

public  TypeName  makeTypeName (  String  typeName  ) ; 

/** 

*  Create  a  new  instance  of  TypeName. 

*  ©param  theClass  The  class  of  the  type. 

*  ©return  Returns  a  new  instance  of  TypeName  representing  the  class  specified  by  the 
argument  theClass. 

*/ 

public  TypeName  makeTypeName (  Class  theClass  ) ; 

/** 

*  Creates  a  new  instance  of  TypeName  that  represents  an  array  of  the  specified 

*  type  with  the  number  of  dimensions  specified  by  dimensionCount . 

*  ©param  typeName  The  type  name  (Java  signature  format)  of  the  element  of  the  array. 

*  ©param  dimensionCount  The  number  of  dimensions  the  new  array  type  should  have. 

*  ©return  Returns  a  new  instance  of  TypeName  representing 

*  an  array  with  elements  that  are  of  the  type  specified 

*  by  the  argument  typeName. 

*/ 

public  TypeName  makeArrayTypeName (  String  typeName,  int  dimensionCount  ) ; 

/** 

*  Creates  a  new  instance  of  TypeName  that  represents  an  array  of  the  specified 

*  type  with  the  number  of  dimensions  specified  by  dimensionCount. 

*  ©param  typeName  The  class  of  the  element  of  the  array. 

*  ©param  dimensionCount  The  number  of  dimensions  the  new  array  type  should  have. 
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*  ©return  Returns  a  new  instance  of  TypeName  representing 

*  an  array  with  elements  that  are  of  the  type  specified 

*  by  the  argument  theClass. 

*/ 

public  TypeName  makeArrayTypeName (  Class  theClass,  int  dimensionCount  ); 


19.  FIOMFactory.java 

package  mil . navy . nps . cs . oomi . f iom; 

import  java . lang . ref lect . * ; 

/** 

*  A  class  factory  for  all  the  interfaces  defined  in  the 

*  <code>mil . navy . nps . cs . oomi . fiom</code>  package. 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 


public  class  FIOMFactory  { 

/** 

*  The  default  factory,  defaults  to  null. 
*/ 

static  FIOMFactory  _def aultFactory  =  null; 


Constructor  _f iomConstructor ; 
Constructor  __ccrConstructor ; 


Constructor  _attributeConstructor; 
Constructor  _attributeMappingConstructor; 


Constructor  _typeNameConstructor; 


/** 

*  ©param  attributelmplClass  The  implementation  class  of  Attribute  interface. 
*/ 

public  FIOMFactory ( 
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String  fiomlmplClass, 

String  ccrlmplClass, 

String  attributelmplClass, 

String  attributeMappinglmplClass , 

String  typeNamelmplClass  ) 

throws  ClassNotFoundException, 

NoSuchMethodException, 

InvocationTargetException, 

I 1 legal Ac cess Except ion, 

InstantiationException  { 

f iomConstructor  =  getConstructor (  Class . forName (  fiomlmplClass  ), 

new  Class []  (  String. class  }  ); 

ccrConstructor  =  getConstructor (  Class . forName (  ccrlmplClass  ), 

new  Class []  (  FCR. class. 

String . class ,  String. class  }  ); 

.attributeConstructor  =  getConstructor (  Class . forName (  attributelmplClass  ), 

new  Class []  (  Attribute . class. 

String . class ,  TypeName . class  }  ); 

.attributeMappingConstructor  =  getConstructor (  Class . forName (  attributeMappinglmplClass  ), 

new  Class[]  <  Attribute []. class. 

Attribute . class  }  ); 

typeNameConstructor  =  getConstructor (  Class . forName (  typeNamelmplClass  ), 


new  Class[]  ( String . class }  ); 


/** 

*  Sets  the  default  factory. 

*/ 

public  static  void  _setDefaultFactory (FIOMFactory  f)  ( 
_defaultFactory  =  f; 

} 

public  static  FIOMFactory  _def aultFactory ( )  ( 

return  _def aultFactory ; 

} 


protected  Constructor  getConstructor]  Class  els.  Class]]  args  ) 

throws  NoSuchMethodException  ( 

try  { 

return  els . getConstructor (args) ; 

> 

catch  (NoSuchMethodException  exc)  ( 

throw  constructorException (  els,  args  ); 

> 
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protected  NoSuchMethodException  constructorException (  Class  els.  Class []  args  )  ( 


StringBuffer  sb  =  new  StringBuf fer (50)  ; 
if  (args . length>0) 

sb . append (args [0 ] . get Name ( ) )  ; 
for  (int  1=1;  i<args . length;  i++)  ( 

sb. append (  ",  "  +  args [i] .getName ()  ); 


return  new  NoSuchMethodException ( 

+ 

} 


"public  Constructor ( "  +  sb . toString ( ) 
")  not  found  in  "  +  els . getName ( )  ); 


/** 

*  Creates  new  instances  of  Attributes. 

*  The  newly  created  Attribute  will  be  added  to  the  parent. 

*/ 

public  Attribute  makeAttribute (  Attribute  parent. 

String  name,  TypeName  type  )  { 

Object!]  args  =  {  parent,  name,  type  }; 
try  { 

return  (Attribute)  _att ributeConstructor . newlnstance (args )  ; 

} 

catch  (Exception  exc)  { 

throw  new  Runt imeExcept ion (exc . getMessage ( ) )  ; 

} 


protected  static  void  pi (String  m)  ( 
System. out . println (m)  ; 

} 


/** 

*  Creates  new  instance  of  CCR. 

*/ 

public  CCR  makeCCR (  FCR  fer.  String  systemName,  String  ccrName  )  ( 

Object!]  args  =  {  fer,  systemName,  ccrName  }; 
return  (CCR)  newlnstance (  _ccrConstructor ,  args  ) ; 


/** 

*  Creates  new  instances  of  TypeName. 

*  @param  typeName  The  type  name  (Java  signature  format) . 
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*  ©return  Returns  a  new  instance  of  TypeName  representing  the  type  specified  by  the 
argument  typeName. 

*/ 

public  TypeName  makeTypeName (  String  typeName  )  { 

Object []  args  =  {  typeName  }; 

return  (TypeName)  newlnstance (  _typeNameConstructor,  args  ); 


/** 

*  Create  a  new  instance  of  TypeName. 

*  ©param  theClass  The  class  of  the  type. 

*  ©return  Returns  a  new  instance  of  TypeName  representing  the  class  specified  by  the 
argument  theClass. 

*/ 

public  TypeName  makeTypeName (  Class  theClass  )  { 

return  makeTypeName (theClass . getName ( ) ) ; 


/** 

*  Creates  a  new  instance  of  TypeName  that  represents  an  array  of  the  specified 

*  type  with  the  number  of  dimensions  specified  by  dimensionCount . 

*  ©param  typeName  The  type  name  (Java  signature  format)  of  the  element  of  the  array. 

*  ©param  dimensionCount  The  number  of  dimensions  the  new  array  type  should  have. 

*  ©return  Returns  a  new  instance  of  TypeName  representing 

*  an  array  with  elements  that  are  of  the  type  specified 

*  by  the  argument  typeName. 

*/ 

public  TypeName  makeArrayTypeName (  String  typeName,  int  dimensionCount  )  { 

Object []  args  =  {  encodeTypeName (typeName, dimensionCount )  }; 

return  (TypeName)  newlnstance (  _typeNameConstructor,  args  ); 


/** 

*  Creates  a  new  instance  of  TypeName  that  represents  an  array  of  the  specified 

*  type  with  the  number  of  dimensions  specified  by  dimensionCount. 

*  ©param  typeName  The  class  of  the  element  of  the  array. 

*  ©param  dimensionCount  The  number  of  dimensions  the  new  array  type  should  have. 

*  ©return  Returns  a  new  instance  of  TypeName  representing 

*  an  array  with  elements  that  are  of  the  type  specified 

*  by  the  argument  theClass. 

*/ 

public  TypeName  makeArrayTypeName (  Class  theClass,  int  dimensionCount  )  { 

return  makeArrayTypeName (  theClass . getName () ,  dimensionCount  ); 

} 


/** 

*  Creates  an  instance  of  AttributeMapping . 


105 


/ 


public  AttributeMapping  makeAttributeMapping ( 

Attribute []  f romAttributes, 

Attribute  toAttribute  )  { 

Object []  args  =  {  f romAttributes,  toAttribute  }; 

return  (AttributeMapping)  newlnstance (  _attributeMappingConstructor,  args  ) ; 

} 


/** 

*  Creates  new  instances  of  the  class  declaring  the  specified  constructor. 

*/ 

protected  Object  newlnstance (  Constructor  constructor.  Object []  args  )  { 

try  { 

return  constructor . newlnstance (args) ; 

} 

catch  (Exception  exc)  { 

throw  new  Runt imeExcept ion (exc . getClass ( ) . getName ( )  +  " :  "  +  exc . getMessage ( ) ) 

} 


/** 

*  Decodes  the  type  (in  internal  Java  signature  format) 

*  into  source  code  format  (human-friendly  format) . 

*/ 

public  static  String  decodeTypeName (String  qualif iedTypeName)  { 
if  (qualif iedTypeName . indexOf ('[')! =-l )  { 

StringBuffer  result  =  new  StringBuf fer ( ) ; 

String  className  =  qualif iedTypeName; 
int  len  =  className . length ()  ; 
int  i  =  0; 

while  (className . charAt (i) =='[' )  { 

result . append ("[]"); 
i++; 

} 


String 

type 

switch 

(className 

.charAt (i) )  ( 

case 

'B '  : 

type 

=  byte . class . getName () ;  break; 

case 

'C'  : 

type 

=  char . class . getName  () ;  break; 

case 

'D '  : 

type 

=  double . class . getName () ;  break 

case 

'F '  : 

type 

=  f loat . class . getName () ;  break; 

case 

'  I '  : 

type 

=  int . class . getName  () ;  break; 
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case  'J' 


type  =  long . class . getName () ;  break; 
case  'S':  type  =  short . class . getName () ;  break; 
case  ' Z ' :  type  =  boolean . class . getName () ;  break; 
case  'L':  type  =  className . substring (i+1 , len-1 ) ;  break; 
default : 
type  = 

} 

result . insert (0,  type); 
return  result . toString ( )  ; 

} 

else 

return  qualif iedTypeName; 


/** 

*  Encodes  the  specified  type  name  (non-array  type) 

*  into  its  qualified  type  name  (internal  Java  signature  format) 

*  as  an  array. 

*  @param  qualif iedTypeName  The  non-array  qualified  type  name  to  be  the 

*  element  type  of  the  array. 

*  ©param  dimCount  The  number  of  dimensions  the  array  should  have. 

*  ©return  The  internal  Java  signature  of  array, 

*  if  the  parameter  dimCount==0,  parameter  qualif iedTypeName  is 

*  returned  with  no  change . 

*/ 

public  static  String  encodeTypeName (String  qualif iedTypeName, 

int  dimCount)  { 

String  result; 
if  (dimCount ==0) 

return  qualif iedTypeName; 

//  encoding  needed  only  if  dimension  is  1  or  more 
if  (qualif iedTypeName . equals (byte . class . getName ( ) ) ) 
result  =  "B"; 

else  if  (qualif iedTypeName . equals (char . class . getName ()) ) 
result  =  "C"; 

else  if  (qualif iedTypeName . equals (double . class . getName ()) ) 
result  =  "D"; 

else  if  (qualif iedTypeName . equals (float . class . getName ()) ) 
result  =  "F"; 

else  if  (qualif iedTypeName . equals (int . class . getName ()) ) 
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result 


I"; 

else  if  (qualif iedTypeName . equals (long . class . getName ()) ) 
result  =  "J"; 

else  if  (qualif iedTypeName . equals (short . class . getName ()) ) 
result  =  "S"; 

else  if  (qualif iedTypeName . equals (boolean . class . getName ()) ) 
result  =  "Z"; 
else 

result  =  "L"  +  qualif iedTypeName  + 

StringBuffer  sb  =  new  StringBuf f er (dimCount ) ; 
for  (int  i=0;  i<dimCount;  i++)  { 

sb . append ("["); 

} 

return  sb  +  result; 


20.  Schema.java 

package  mil . navy . nps . cs . oomi . f iom; 

import  java . util . List ; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  interface  Schema  { 

/** 

*  Returns  actual  type  name  of  the  class 

*  this  Schema  object  describes. 

*/ 

public  TypeName  getTypeO; 

/** 

*  Sets  actual  type  name  of  the  class 

*  this  Schema  object  describes. 
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V 

public  void  setType (TypeName  type); 

/** 

*  Adds  a  new  attribute  to  this  schema. 

*/ 

public  void  addAttribute (  Attribute  attr  ); 


/** 

*  Adds  a  top  level  Attribute  to  this  schema. 

*  @param  parent  The  parent  of  the  new  attribute. 

*  @param  name  The  name  of  the  new  attribute. 

*  Sparam  type  The  type  name  of  the  new  attribute. 

*  Dreturn  A  reference  to  the  newly  added  attribute. 

*/ 

public  Attribute  addAttribute (  String  name,  TypeName  type  ); 

/** 

*  Removes  the  specified  attribute  from  the  top-level  list. 

*/ 

public  void  removeAttribute (  Attribute  attr  ); 

/** 

*  Returns  an  array  of  top-level  attributes. 

*/ 

public  Attribute)]  getAttribute ( ) ; 

/** 

*  Returns  the  attribute  in  this  Schema 

*  that  is  equal  to  the  specified  Attribute. 

*/ 

public  Attribute  f indAttribute (  Attribute  attr  ); 

/** 

*  Enumerates  all  attributes  and  their  descendents  and  add  them  to  the  specified  list, 

*  effectively  flattening  the  attribute  tree  into  a  list. 

*/ 

public  void  enumerateAttributes (  List  result  ) ; 

/** 

*  Enumerates  all  attributes  and  their  descendents  and  puts  them  in  array 

*  and  returns  this  array. 

*/ 
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public  Attribute []  enumerateAttributes (  ); 


} 

21.  TypeName.java 

package  mil . navy . nps . cs . oomi . f iom; 

/** 

*  Represents  a  type  name  in  the  internal  Java  signature  format. 

*  This  is  introduced  to  prevent  confusion  when  using  only  a  String  type 

*  to  specify  both  Name  and  Type  of  an  attribute. 

*  The  type  name  represented  by  an  instance  of  TypeName  does  not  necessarily 

*  have  to  be  valid  at  runtime,  that  is,  the  type  name  can  be  a  non-compiled 

*  type. 

*  @author  LSC 

*  (Aversion  1 . 0 

*/ 

public  interface  TypeName  { 

/** 

*  An  array  of  names  of  primitive  types . 

V 

final  String [ ]  PRIMITIVE_NAMES  =  { 

boolean . class . getName  ( ) , 
byte . class . getName ( ) , 
char . class . getName ( ) , 
short . class . getName ( ) , 
int . class . getName ( ) , 
long .class . getName ( ) , 
float . class . getName ( ) , 
double . class . getName ( ) 

}  ; 

/** 

*  Returns  the  type  name  in  internal  Java  signature  format . 

*/ 

public  String  toStringO; 

/** 
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*  Duplicates  this  TypeName  object. 

*/ 

public  TypeName  copyO; 

/** 

*  Returns  if  the  specified  obj  is  of  the  same  type, 

*  true  if  and  only  if  obj  implements  TypeName 

*  and  this . toString (). equals (  ob j . toString  ( )  ) 

*/ 

public  boolean  equals (Object  obj); 

/** 

*  Implementor  shall  ensure  that  for  any  TypeName  tl,  t2, 

*  tl . equals (t2)  ==>  t 1 . hashCode ( ) ==t2 . hashCode ( ) . 

*/ 

public  int  hashCode (); 

/** 

*  Indicates  if  the  type  represented  by  this  TypeName  object  is  an  array. 

*/ 

public  boolean  isArrayO; 

/** 

*  Indicates  if  the  type  represented  by  this  TypeName  object  is  a  primitive  type. 
*/ 

public  boolean  isPrimitive { )  ; 


C.  PACKAGE:  mil.navy.nps.cs.oomi.exceptions 

1.  DuplicateKeyException.java 

package  mil . navy . nps . cs . oomi . exceptions ; 

/** 

*  Indicates  a  duplicate  FIOM  name  was  found. 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  DuplicateKeyException  extends  OOMIException  { 


ill 


public  DuplicateKeyExcept ion ( String  msg)  { 
super (ErrorCodes . DUPLICATE_KEY,  msg)  ; 


2.  ErrorCodes.java 

package  mil . navy . nps . cs . oomi . exceptions ; 

/** 

*  Defines  the  set  of  error  codes . 

*  @author  LSC 

*  (Aversion  1 . 0 

V 

public  class  ErrorCodes  { 

/** 

*  Not  to  be  instantiated. 

*/ 

private  ErrorCodes ()  { 

} 

/** 

*  Default  error  code  value. 

*/ 

public  static  final  int  UNKNOWN  =  -1; 

/** 

*  Indicates  a  duplicate  key  value  encountered. 

*/ 

public  static  final  int  DUPLICATE_KEY  =  -10; 

/** 

*  Indicates  a  unique  name  violation. 

V 

public  static  final  int  UNI QUE_NAME_VI OLAT I ON  =  -20 

/** 

*  Indicates  an  unknown  URI . 

*/ 

public  static  final  int  UNKNOWN_URI  =  -30; 
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*  Indicates  an  unmarshalling  exception. 
*/ 

public  static  final  int  UNMARSHAL  =  -200; 
/** 

*  Indicates  an  unmarshalling  exception. 
*/ 

public  static  final  int  MARSHAL  =  -210; 


3.  IntrospectionException.java 

package  mil . navy . nps . cs . oomi . exceptions ; 


^  -k  -k 


*  ©author  LSC 

*  ©version  1.0 
*/ 

public  class  IntrospectionException  extends  Exception  { 

public  IntrospectionException (String  s)  { 
super (s) ; 

} 

public  Introspect ionExcept ion (Exception  e)  { 
super (e . getMessage ( ) )  ; 


4.  OOMIException.java 

package  mil . navy . nps . cs . oomi . exceptions ; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  OOMIException  extends  Exception  { 

/** 

*  The  error  code  of  this  exception. 
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/ 


int  _errorCode  =  ErrorCodes . UNKNOWN; 

public  OOMIExcept ion (  int  errorCode,  String  errorMsg  )  { 

super (errorMsg) ; 

_errorCode  =  errorCode; 

} 


5.  UniqueNameViolationException.java 

package  mil . navy . nps . cs . oomi . exceptions ; 

/** 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  class  UniqueNameViolationException  extends  OOMIException  { 
public  UniqueNameViolationException (String  msg)  { 
super (ErrorCodes . UN I QUE_NAME_V I OL AT I ON ,  msg) ; 


6.  UnknownNameSpaceURIException.java 

package  mil . navy . nps . cs . oomi . exceptions ; 

import  java . net . URL; 

/** 

*  ©author  LSC 

*  ©version  1.0 
*/ 


public  class  UnknownNameSpaceURIException  extends  OOMIException  { 


public  UnknownNameSpaceURIException (URL  unknownURI)  { 
super (  ErrorCodes . UNKNOWN_URI , 

"The  namespace  URI :  "  +  unknownURI  + 

"  is  not  defined  in  this  Federation."  ); 
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7.  UnmarshalException.java 


package  mil . navy . nps . cs . oomi . exceptions ; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  UnmarshalException  extends  OOMIException  { 

public  UnmarshalExcept ion ( String  msg)  { 
super  (ErrorCodes . UNMARSHAL,  msg); 

} 

} 

D.  PACKAGE:  mil.navy.nps.cs.oomi.impl 

1.  Attributelmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  java . util . List ; 
import  java . util . Arrays ; 
import  java . util . Iterator ; 
import  java . util . List Iterator ; 
import  java . util . ArrayList ; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  Directly  manipulates  the  _children  field 

*  of  mil . navy . nps . cs . oomi . translator . Attribute . 

*  <p> 

*  May  be  modified  to  inherit  from  mil . navy . nps . cs . oomi . translator .Attribute  since  this  class 

*  might  be  used  for  code  generation  of  FCRs  in  future. 

*  <p> 

*  ©author  LSC 

*  ©version  1 . 0 
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public  class  Attributelmpl  implements  mil . navy . nps . cs . oomi . fiom . Attribute  { 

/** 

*  The  parent  of  this  attribute. 

*/ 

Attribute  _parent  =  null;  //  defaults  to  null,  indicating  no  parent 

/** 

*  All  the  children  that  composes  this  attribute. 

*/ 

protected  List  _childList  =  new  ArrayListO; 

/** 

*  Attribute  name. 

*/ 

protected  String  _name  =  null; 

/** 

*  Attribute  type. 

*/ 

protected  TypeName  _type  =  null; 

//- 

//- 

//- 

/** 

*  MinOccurs . 

*/ 

protected  int  _minOccurs  =  0; 

/** 

*  MaxOccurs . 

*/ 

protected  int  _maxOccurs  =  0; 

/** 

*  Public  no-argument  constructor  required  for  Castor  Unmarshaller . 

*/ 

public  Attributelmpl ( )  { 

} 
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/** 

*  Creates  an  instance  with  specified  parent,  name  and  type. 

*/ 

public  Attributelmpl {  Attribute  parent.  String  name,  TypeName  type  )  { 

//setParent (parent) ; 
setName (name)  ; 
setType (type) ; 
if  (parent==null ) 
setParent  (null) ; 
else 

( (Attributelmpl) parent ) . addChild (this ) ; 


/** 

*  Sets  the  parent. 

*/ 

protected  void  setParent (Attribute  val)  ( 
this._parent  =  val; 

} 

public  Attribute  getParentO  { 
return  this ._parent ; 

} 

public  void  setName  (String  name)  { 

_name  =  name ; 


public  void  setType  (TypeName  type)  ( 
_type  =  type; 

} 


public  String  getNameO  { 
return  _name  ; 

) 

public  TypeName  getTypeO  { 
return  _type; 

) 


/** 

*  Performs  a  shallow  copy  from  s  to  d, 

*  less  the  _type,  _name  and  _childList  field. 
*/ 
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protected  static  void  copyContent (  Attributelmpl  s,  Attributelmpl  d  )  ( 


d . setMaxOccurs ( s . getMaxOccurs ( )  )  ; 
d . setMinOccur s ( s . getMinOccur s ( )  )  ; 


/** 

*  Clones  the  descendents  of  the  specified  Attributelmpl  object  and 

*  make  this  object  the  parent  of  the  clones. 

*/ 

protected  void  cloneDescendents (  Attributelmpl  attr  )  ( 

/ /p  (  "cloneDesc:  "  +  attr . fullPath ( )  +  "  "  +  attr . childCount ( )  ); 

if  (attr .childCount () ==0) 
return; 
else  { 

Iterator  iter  =  attr ,_childList . iterator  () ; 
while  (iter .hasNext () )  { 

Attributelmpl  child  =  (Attributelmpl)  iter.nextO; 

Attributelmpl  childCopy; 
try  { 

childCopy  =  (Attributelmpl)  newChild(  child . getName () ,  child . getType (). copy ( )  ); 

copyContent (  child,  childCopy  )  ; 
childCopy . cloneDescendents (  child  ); 

} 

catch  (UniqueNameViolationException  exc)  { 

//  ignore  this  exception,  since  it  should  never  occur  when  cloning 
//  an  attribute,  in  case  it  occurs,  throw  a  RuntimeException 

throw  new  RuntimeException (  "cloneDescendents (Attribute)  encountered 

UniqueNameViolationException"  )  ; 

) 

} 

) 

) 


public  Attribute  copyO  ( 

FIOMFactory  f  =  Factory Impl . factory ()  ; 
if  (getParent () ==null)  { 

Attributelmpl  result  =  (Attributelmpl)  f . makeAttribute (null,  getName () , 

getType  ()  .  copy  ()  )  ; 

copyContent (  this,  result  ); 

result . cloneDescendents (this)  ; 

return  result; 

} 

else  { 

//  Copy  the  ancestors 
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Attribute!]  array  =  pathToArray ( )  ; 

Attribute  parent  =  null; 

Attributelmpl  result  =  null; 

for  {int  i=0;  i<array . length;  iff)  { 

result  =  (Attributelmpl)  f .makeAttribute (parent,  array [i] . getName () , 

array [i]  . getType ( )  . copy ( ) )  ; 

copyContent (  this,  result  ); 

parent  =  result; 

} 

result . cloneDescendents (this)  ; 
return  result; 


public  int  childCountO  { 
return  _childList . size  ( ) ; 

}; 

public  Attribute!]  getChildO  ( 

return  (Attribute!])  _childList . toArray (  new  Attribute [childCount () ]  ); 

} 

/** 

*  Adds  the  specified  child  attribute  to  this  Attributelmpl. 

*/ 

public  void  addChild (Attributelmpl  attr)  { 

_childList . add (attr)  ; 
attr. setParent (this)  ; 

} 

/** 

*  Sets  the  list  of  children  with  the  specified  array. 

*  Generally,  to  be  called  only  from  the  Castor  Unmarshaller . 

*/ 

public  void  setChild(  Attribute!]  v  )  ( 

_childList . clear ( ) ; 

for  (int  i=0;  i<v. length;  i+t)  ( 

this . addChild ( (Attributelmpl)  v [i] ) ; 

} 

} 

public  Attribute  findChild (String  attributeName)  ( 

Iterator  iter  =  _childList . iterator ()  ; 

Attribute  curr; 

while  (iter . hasNext ( ) )  { 
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curr 


(Attribute)  iter. next (); 


if  (curr . getName ( ) . equalsIgnoreCase (attributeName) ) 
return  curr; 

} 

return  null; 


public  Attribute  f indDescendent (Attribute  attr)  { 
Iterator  iter  =  _childList . iterator () ; 

Attribute  curr; 

Attribute  c; 

while  (iter . hasNext ( ) )  { 

curr  =  (Attribute)  iter.nextO; 
if  (curr . equals (attr ) ) 
return  curr; 

c  =  curr . f indDescendent (attr ) ; 
if  (c!=null) 
return  c; 

} 

return  null; 


public  boolean  removeDescendent (  Attribute  descendentToRemove  )  { 

//  Assumption:  any  Attribute  does  not  appear  more  than  once  in  a  hierarchy. 
Listlterator  iter  =  _childList . listlterator ( ) ; 
boolean  done  =  false; 

Object  curr; 

while  (iter . hasNext ( )  &&  !done)  { 
curr  =  iter.next(); 
if  (curr==descendentToRemove)  { 
iter . remove ( ) ; 

( (Attributelmpl) curr) . setParent (null) ; 
done  =  true; 


if  ( ! done)  { 

Iterator  i  =  _childList . iterator ()  ; 
while  (i. hasNext ()  &&  !done)  { 

done  =  ( (Attribute) (i.next () ) ) .removeDescendent (descendentToRemove) ; 


return  done; 

} 
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public  Attribute  newChild(  String  attributeName,  TypeName  attributeType) 


throws  UniqueNameViolationException  { 
if  (  findChild (attributeName)  !=  null  ) 
throw  new  UniqueNameViolationException ( 

"Attribute  "  + 
getNameO  + 

"  already  has  a  child  attribute  named  "  + 
attributeName  ) ; 

Attribute  result  =  Factorylmpl . factory (). makeAttribute (this , 

attributeType) ; 


//new  Attributelmpl (this,  attributeName,  attributeType); 
//_childList . add (result )  ; 
return  result; 


public  int  hashCodeO  { 

return  this . fullPath ( ) . hashCode ( ) ; 

} 


public  boolean  equals (  Object  o  )  ( 

if  (this==o) 
return  true; 

Attribute  attr  =  (Attribute)  o; 

if  (  getName ( ) ==null  I  I  getType ( ) ==null  I  I 

attr . getName ( ) ==null  I  I  attr . getType () ==null  ) 
return  false; 

if  (  getName  ().  equals  (attr .  getName  ()  )  &&  getType  ().  equals  (attr .  getType  ()  )  ) 
if  (  getParent ( ) ==attr . getParent ( )  ) 
return  true; 

else  if  (  getParent  () ==null  I  I  attr . getParent () ==null  ) 
return  false; 
else 

return  getParent ( )  . equals (attr . getParent  ( ) ) ; 


else 

return 


false; 


public  void  enumerateDescendents (  List  result  )  ( 

Iterator  i  =  _childList . iterator () ; 

Attribute  attr; 


attributeName , 


121 


while  (i . hasNext ( ) )  { 

attr  =  (Attribute)  i.nextO; 
result . add (attr) ; 

attr . enumerateDescendents (result) ; 


public  boolean  isMandatory ( )  { 

return  getMinOccurs ( ) >=1 ; 

} 


public  boolean  isArrayO  { 
return  _type . isArray ( )  ; 
//return  getMaxOccurs ( ) >1 ; 

} 


public  String  fullPathO  { 

List  path  =  new  ArrayList (5)  ; 

Attribute  curr  =  this; 
while  (curr!=null)  { 
path . add (curr )  ; 
curr  =  curr . getParent ( )  ; 

} 

StringBuffer  result  =  new  StringBuf fer ( ) ; 

Object!]  objs  =  path . toArray ( ) ; 

Attribute  attr; 
int  start  =  ob j s . length-1 ; 
attr  =  (Attribute)  objs [start]; 
result . append (attr . getName ( ) ) ; 
for  (int  i=start-l;  i>=0;  i — )  ( 

attr  =  (Attribute)  objs[i]; 

result . append (Attribute . NAME_SEPARATOR  +  attr . getName () ) 

} 

return  result . toString ( )  ; 

} 


public  Attribute!]  pathToArray ( )  ( 

List  path  =  new  ArrayList (5)  ; 
Attribute  curr  =  this; 
while  (curr!=null)  { 
path . add (curr )  ; 
curr  =  curr . getParent ()  ; 

} 
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Attribute []  result  =  new  Attribute [path . size ()] ; 
/ /  reverse  the  order 
if  (result . length>0)  { 
int  i  =  result . length-1 ; 

Iterator  iter  =  path . iterator () ; 

Attribute  a; 

while  (iter . hasNext ( ) )  { 

a  =  (Attribute) iter . next ()  ; 
result [ i ]  =  a; 


return  result; 

} 


//- 

//-  Getters  and  Setters. 

//- 

public  int  getMinOccurs ( )  { 

return  _minOccurs; 

} 

public  void  setMinOccurs (  int  v  )  { 

_minOccurs  =  v; 

} 

public  int  getMaxOccurs ( )  { 

return  _maxOccurs; 

} 

public  void  setMaxOccurs (  int  v  )  { 

_maxOccurs  =  v; 

} 

public  static  void  p (String  m)  { 
System. out . print In (m) ; 


2.  AttributeMappinglmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 


import  mil . navy . nps . cs . oomi . f iom. * ; 


public  class  AttributeMappinglmpl  implements  AttributeMapping  { 
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/** 

*  Source  attributes. 

*/ 

protected  Attribute  _sourceAttr [ ] ; 

/** 

*  Target  attribute. 

*/ 

protected  Attribute  _targetAttr; 

/** 

*  Holds  the  many-to-one  mapping  from  attributes  of 

*  one  class  to  the  attribute  of  another  class. 

*/ 

public  AttributeMappinglmpl (  Attribute  source!] ,  Attribute  target  )  { 

_sourceAttr  =  new  Attribute [source . length]  ; 

System. arraycopy (  source,  0,  _sourceAttr,  0,  source . length  ); 
_targetAttr  =  target; 

} 


/** 

*  Returns  a  copy  of  the  array  of  from  attributes . 

*/ 

public  Attribute]]  getSourceAttributes  ( )  ( 

Attribute]]  result  =  new  Attribute [_sourceAttr . length] ; 

System. arraycopy (_sourceAttr,  0,  result,  0,  _sourceAttr . length) ; 
return  result; 


public  String  toStringO  { 
if  (_sourceAttr . length>0)  { 

StringBuffer  result  =  new  StringBuf fer ( 64 ) ; 
result . append (  _sourceAtt r [ 0 ] . f ullPath ( )  ); 

for  (int  i=l;  i<_sourceAttr . length;  i++)  { 

result . append (  ",  "  ); 

result . append (  _sourceAttr [i] . fullPath ( )  ); 

} 

result . append ( "  — >  "  +  _targetAttr . fullPath ())  ; 
return  result . toString ()  ; 

} 

else 
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return 


} 

/** 

*  Returns  the  target  attribute. 

*/ 

public  Attribute  getTargetAttribute ( )  ( 

return  _targetAttr; 

} 


public  Attribute!]  f romAttributes ( )  { 

return  getSourceAttributes ()  ; 

} 


public  Attribute  toAttribute ()  ( 

return  getTargetAttribute]); 

} 


3.  CCRImpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  java. util.*; 

import  mil . navy . nps . cs . oomi .* ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


/** 

*  A  reference  implementation  of  the  Component  Class  Representation  (CCR) . 

*  Needs  to  maintain  the  mandatory  attributes  of  the  corresponding  FCR. 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  class  CCRImpl  implements  CCR,  Comparable  { 

/** 

*  FCR  to  CCR  attribute  mappings. 
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V 

protected  List  _fcrToCcrAttrMappingList  =  new  ArrayListO; 

/'** 

*  The  system  name  of  this  CCR. 

*/ 

protected  String  _systemName  = 

/** 

*  The  name  of  this  CCR. 

V 

protected  String  _ccrName  = 

/** 

*  The  FCR  corresponding  to  this  CCR. 

*/ 

protected  FCR  _fcr  =  null; 

/** 

*  The  schema  for  this  CCR. 

*/ 

protected  CCRSchema  _ccrSchema  =  new  CCRSchemalmpl ( ) ; 

/** 

*  The  fully  qualified  name  of  the  Castor  generated  class  for  the  XML  schema. 
*/ 

protected  String  _javaClassName  = 

/** 

*  The  URL  to  the  XML  schema  for  which  this  CCR  is  defined  for. 

*/ 

protected  String  _xmlNameSpaceURI  = 

/** 

*  An  array  of  mandatory  FCR  attributes . 

*  Transient  field,  built  from  _f crToCcrAttrMappingList  when  required. 

*/ 

protected  Set  _mandatoryFCRAttributes  =  new  HashSet  () ; 

/** 

*  Constructor  required  by  Castor  Unmarshaller . 

*/ 

public  CCRImpl ( )  { 
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/** 

*  Initializes  the  CCR. 

*  If  the  specified  FCR  is  not  null,  this  CCR  shall  join  the  specified  FCR. 

*  @param  fcr  The  FCR  this  CCR  will  join. 

*  @param  systemName  System  name  of  this  CCR. 

*  @param  ccrName  Name  of  this  CCR. 

*/ 

public  CCRImpl (  FCR  fcr.  String  systemName,  String  ccrName  )  { 

joinFCR (fcr) ; 
setCCRName (ccrName) ; 
setSystemName (systemName) ; 


/** 

*  Sets  the  name  of  this  CCR. 

*  Public  access  required  by  Castor  Unmarshaller . 
*/ 

public  void  setCCRName (String  ccrName)  { 

_ccrName  =  ccrName; 

} 


public  String  getCCRNameO  { 
return  _ccrName; 

} 


/** 

*  Sets  the  FCR  of  this  object. 

*  Used  only  for  Castor  Marshaling/Unmarshaling. 
*/ 

void  setFCR (FCR  fcr)  { 

_fcr  =  fcr; 

} 


public  FCR  getFCR ( )  { 

return  _fcr; 

) 


public  void  joinFCR (FCR  newFCR)  ( 
if  (newFCR ! =null)  { 

( (FCRImpl )  newFCR) . addCCR (  this  ); 

) 
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} 


public  CCRSchema  getCCRSchema ( )  { 

return  _ccrSchema; 


/** 

*  Public  access  required  by  Castor  Unmarshaller . 
*/ 

public  void  setCCRSchema (  CCRSchema  v  )  { 

_ccrSchema  =  v; 

} 


public  String  get JavaClassName ( )  { 

return  _javaClassName; 

} 


public  void  set JavaClassName (  String  javaClassName  )  { 

_ javaClassName  =  javaClassName; 

} 


public  String  getXMLNameSpaceURI ( )  { 

return  _xmlNameSpaceURI ; 

} 


public  void  setXMLNameSpaceURI (  String  xmlNameSpaceURI  )  { 

_xmlNameSpaceURI  =  xmlNameSpaceURI; 

} 


public  String  getSystemName ( )  { 

return  _systemName; 

} 

public  void  setSystemName (String  v)  { 

_systemName  =  v; 

} 

public  AttributeMapping [ ]  getFCRToCCRAttributeMapping ( )  { 

return  (AttributeMapping [] )  _f crToCcrAttrMappingList . toArray ( 

new  AttributeMapping [_f crToCcrAttrMappingList . size () ]  ) 

} 

public  void  setFCRToCCRAttributeMapping (  AttributeMapping [ ]  v  )  { 

clearFCRToCCRAttributeMappings ()  ; 
for  (int  i=0;  i<v. length;  i++)  { 

__f  crToCcrAttrMappingList .  add  (v [i]  )  ; 

} 
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} 

public  Attribute!]  mandatoryFCRAttributes ( )  ( 

return  (Attribute!])  mandatoryFCRAttributeSet ( ) . toArray ( 

new  Attribute [mandatoryFCRAttributeCount () ]  ) 

} 

public  boolean  isMandatoryFCRAttribute (  Attribute  fcrAttr  )  ( 

return  mandatoryFCRAttributeSet () .contains (fcrAttr) ; 

} 

public  int  mandatoryFCRAttributeCount ( )  ( 

return  mandatoryFCRAttributeSet  ( )  .sized  ; 

} 


/** 

*  Returns  the  mandatory  FCR  attributes  set,  builds  the  set  by  calling 

*  !@link  #buildMandatoryFCRAttributeSet ( ) }  if  the  set  is  empty. 

*/ 

protected  Set  mandatoryFCRAttributeSet ( )  { 

if  (_mandatoryFCRAttributes . size () ==0) 
buildMandatoryFCRAttributeSet () ; 
return  _mandatoryFCRAttributes; 


*  Builds  the  mandatory  FCR  attributes  set,  based  on  the  current 

*  _fcrToCcrAttrMappingList . 

*/ 

protected  void  buildMandatoryFCRAttributeSet ( )  { 

//  first,  clear  the  existing  set 
_mandatoryFCRAttributes . clear ( )  ; 

CCRSchema  ccrSchema  =  getCCRSchema ( ) ; 

Iterator  iter  =  _f crToCcrAttrMappingList . iterator  () ; 
while  (iter . hasNext ( ) )  { 

AttributeMapping  mapping  =  (AttributeMapping) iter . next () ; 
Attribute!]  fcrAttrs  =  mapping . fromAttributes () ; 

Attribute  ccrAttr  =  mapping . toAttribute () ; 
if  (  ccrSchema . f indAttribute (ccrAttr ). isMandatory ( )  )  ( 

for  (int  i=0;  i<fcrAttrs . length;  i++)  ( 

_mandatoryFCRAttributes . add (fcrAttrs [i] )  ; 

} 
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public  void  addFCRToCCRAttributeMapping (  Attribute []  from.  Attribute  to  )  { 

AttributeMapping  mapping  =  Factorylmpl . factory () .makeAttributeMapping (  from,  to  ) 
_f crToCcrAttrMappingList . add (  mapping  ); 

} 


public  void  clearFCRToCCRAttributeMappings ( )  { 

_f crToCcrAttrMappingList . clear ( )  ; 

} 


/** 

*  Used  mainly  for  sorting  required  during  testing. 

*  Ordering  is  based  on  SystemName  order  followed  by  CCRName. 
*/ 

public  int  compareTo (Ob ject  o)  { 

OCR  ccr  =  (CCR)  o; 
if  (this==o) 
return  0; 
int  c; 

c  =  get SystemName (). compareTo (ccr . getSystemName () ) ; 
if  (c ! =0 ) 
return  c; 
else 

return  getCCRName ( ) . compareTo (ccr . getCCRName ( ) ) ; 

} 

static  void  p (String  m)  { 

System. out . print In (m) ; 


4.  CCRSchemalmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  CCRSchemalmpl  extends  Schemalmpl 
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implements  CCRSchema  { 


/** 

*  Public  no-arg  constructor  required  by  Castor  Unmarshaller . 
*/ 

public  CCRSchemalmpl ( )  { 

} 


5.  Factorylmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  mil . navy . nps . cs . oomi . f iom. * ; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  Factorylmpl  { 

static  FIOMFactory  _def aultFactory  =  null; 

protected  Factorylmpl ( )  { 

} 


public  static  FIOMFactory  newFIOMFactory ( )  { 

try  { 

FIOMFactory  result 
=  new  FIOMFactory ( 

FIOMImpl . class . getName ( )  , 

CCRImpl . class . getName ( ) , 

Attributelmpl . class . getName ( ) , 
AttributeMappinglmpl . class . getName ( )  , 
TypeNamelmpl . class . getName ( )  ); 

return  result; 

} 

catch  (Exception  exc)  { 

throw  new  RuntimeException (exc . getClass ( )  +  " :  "  +  exc . getMessage ( ) ) 

} 


131 


public  static  FIOMFactory  factory ()  { 

if  (_defaultFactory==null) 

_def aultFactory  =  newFIOMFactory ( ) ; 
return  _def aultFactory; 


6.  FCRImpl.java 


package  mil . navy . nps . cs . oomi 

.  impl ; 

import 

java . util . Array List ; 

import 

java . util . Iterator; 

import 

java . util . List ; 

import 

java . util . Set ; 

import 

java. util . HashSet; 

import 

java . util .Arrays; 

import 

java . util . Collections 

; 

import 

java . util . Collection; 

import 

java . net . URL; 

import 

mil . navy . nps . cs . oomi . 

*; 

import 

mil . navy . nps . cs . oomi . 

f iom. *; 

import 

mil . navy . nps . cs . oomi . 

exceptions . * 

/** 

*  Sauthor  LSC 

*  Sversion  1.0 
*/ 

public  class  FCRImpl  implements  FCR  { 

/** 

*  The  name  of  this  FCR. 

*/ 

protected  String  _fcrName  = 

/** 
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*  The  Java  class  name  that  implements  the  FCRInstance  for  this  FCR. 
*/ 

protected  String  _javaClassName; 

/** 

*  The  FEV  that  corresponds  to  this  FCR. 

*/ 

protected  FEV  _fev  =  null; 

/** 

*  The  list  of  CCRs  corresponding  to  this  FCR. 

*/ 

protected  Set  _ccrSet  =  new  HashSetO; 

/** 

*  The  schema  for  this  FCR. 

*/ 

protected  FCRSchema  _fcrSchema  =  new  FCRSchemalmpl ( ) ; 

/** 

*  Required  for  Castor  Marshaller  and  Unmarshaller . 

*/ 

public  FCRImpl ( )  { 


/** 

*  Creates  a  new  instance  with  specified  name. 
*/ 

public  FCRImpl (FEV  fev,  String  fcrName)  { 
setFCRName (fcrName) ; 
setFEV (fev) ; 


public  String  getFCRNameO  { 
return  _fcrName; 

} 


/** 

*  Sets  the  name  of  this  FCR. 

*  To  be  used  only  by  the  constructor 

*  and  during  restoration  from  persistent  storage,  using 

*  Castor  Unmarshaller. 
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V 

public  void  setFCRName (String  fcrName)  ( 
_fcrName  =  fcrName; 

} 


/** 

*  Sets  the  FEV  of  this  FCR. 

*  To  be  used  only  by  the  constructor 

*  and  by  Castor  Unmarshaller  during  restoration  from  persistent  storage. 


*/ 

public  void  setFEV(FEV  value)  ( 
_fev  =  value; 

) 


public  CCR [ ]  getCCRO  { 

return  (CCR [ ] ) _ccrSet . toArray (new  CCR [ccrCount ( ) ] ) ; 

) 


public  FEV  getFEVO  { 
return  _fev; 

} 


public  int  ccrCount ()  { 

return  _ccrSet . size ( )  ; 

) 


public  void  f indCCR (SearchHandler  handler)  ( 
Iterator  iter  =  __ccrSet .  iterator  ()  ; 

CCR  ccr; 

while  (iter . hasNext ( ) )  { 

ccr  =  (CCR)  iter  .next  ()  ; 
if  (  handler . satisfied (ccr)  ) 
handler . add (ccr) ; 

) 

} 


public  CCR [ ]  f indCCR (  String  systemName  )  ( 

java . util . HashSet  result  =  new  java . util . HashSet  () ; 

findCCR(  makeCCRSystemNameSearchHandler (systemName,  result)  ); 

return  ( CCR [ ] )  result . toArray (new  CCR [result . size  ()]) ; 

/* 
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List  result  =  new  ArrayListO; 

Iterator  iter  =  _ccrList . iterator ()  ; 

CCR  ccr ; 

while  (iter . hasNext ( ) )  { 

ccr  =  (CCR) iter .next ()  ; 

if  (  ccr . getSystemName ( ) . equalsIgnoreCase (systemName)  ) 
result . add (ccr) ; 

} 

return  (CCR[])  result . toArray (new  CCR [ result . size ()]) ; 

*/ 

} 

public  CCR  findCCR (String  systemName,  String  ccrName)  { 
Iterator  iter  =  _ccrSet . iterator ()  ; 

CCR  ccr; 

while  (iter . hasNext () )  { 

ccr  =  (CCR) iter .next ()  ; 

if  (  ccr . getSystemName (). equalsIgnoreCase (systemName)  && 
ccr . getCCRName ( ) . equalsIgnoreCase (ccrName)  ) 
return  ccr; 

} 

return  null; 

} 

public  CCR  findCCR (String  systemName,  URL  xmlNameSpaceURI )  { 

if  (xmlNameSpaceURI==null) 
return  null; 

Iterator  iter  =  _ccrSet . iterator ()  ; 

CCR  ccr; 

String  urlString  =  xmlNameSpaceURI . toString ()  ; 
while  (iter . hasNext () )  { 

ccr  =  (CCR) iter .next ()  ; 

if  (  ccr . getSystemName (). equalsIgnoreCase (systemName)  && 
ccr . getXMLNameSpaceURI ( ) . equals (urlString)  ) 
return  ccr; 

} 

return  null; 


public  CCR  findCCR (  URL  xmlNameSpaceURI  )  { 

if  (xmlNameSpaceURI==null) 
return  null; 

Iterator  iter  =  _ccrList . iterator ()  ; 

CCR  ccr; 
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String  urlString  =  xmlNameSpaceURI . toString ( )  ; 
while  (iter . hasNext ( ) )  { 


ccr  =  (CCR) iter .next ()  ; 

if  (  ccr . getXMLNameSpaceURI (). equals (urlString)  ) 
return  ccr; 

} 

return  null; 


*/ 

public  boolean  ccrExists (String  systemName,  String  ccrName)  { 
return  findCCR (systemName,  ccrName) ! =null; 

} 

public  boolean  ccrExists (String  systemName,  URL  xmlNameSpaceURI)  { 
return  findCCR (systemName,  xmlNameSpaceURI )! =null; 

} 


public  CCR  newCCR (String  systemName,  String  ccrName,  URL  xmlNameSpaceURI) 

throws  DuplicateKeyException  { 

if  (  ccrExists (systemName,  ccrName)  ) 

throw  new  DuplicateKeyException (ccrName  +  "  already  exists  for  system:  "  + 

if  (  ccrExists (systemName,  xmlNameSpaceURI)  ) 

throw  new  DuplicateKeyException (xmlNameSpaceURI  +  "  already  exists  for 

systemName) ; 

CCRImpl  ccr  =  new  CCRImpl (this,  systemName,  ccrName); 
if  (  xmlNameSpaceURI ! =null) 

ccr . setXMLNameSpaceURI (  xmlNameSpaceURI . toString ( )  ); 

_ccrSet . add (ccr)  ; 
return  ccr; 


/** 

*  Adds  the  specified  CCR  object  to  this  FCR, 

*  <strong>  the  FCR  field  of  the  CCRImpl  parameter  is  updated  to 

*  point  to  this  object.  </strong> 

*  <p>Also  used  by  Castor  Unmarshaller  only. 


*/ 

public  void  addCCR (  CCR  newCCR  )  { 
( (CCRImpl) newCCR) . setFCR (this) ; 
_ccrSet . add (newCCR)  ; 

} 


systemName) ; 


system:  "  + 
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public  FCRSchema  getFCRSchema ( )  { 


return  _fcrSchema; 

} 

/** 

*  Public  access  required  by  Castor  Unmarshaller . 
*/ 

public  void  setFCRSchema (  FCRSchema  v  )  { 

_fcrSchema  =  v; 


public  String  get JavaClassName ( )  { 

return  _javaClassName; 

} 

public  void  set JavaClassName (String  className)  { 
_ javaClassName  =  className; 

} 


/** 

*  A  factory  method  that  returns  an  instance  of  SearchHandler  for  search  of 

*  CCRs  by  system  name  of  the  CCRs . 

*/ 

public  static  SearchHandler  makeCCRSystemNameSearchHandler ( 

String  systemName, 

java . util . Set  resultSet)  { 

return  new  CCRSystemNameSearchHandler (  systemName,  resultSet  ); 

} 


/** 

*  @param  systemName 

*  @param  xmlNamespaceURI 

*  @param  result  A  single  element  array  to  hold  the  result,  the  element  holds 

*  a  null  value  if  no  match  found. 

*/ 

public  static  CCRKeySearchHandler  makeCCRKeySearchHandler ( 

String  systemName,  URL  xmlNamespaceURI, 

CCR [ ]  result)  { 

if  (result . lengthcl ) 

throw  new  IllegalArgumentException (  "Argument  result  must  not  be  an  empty  array, 
return  new  CCRKeySearchHandler (systemName,  xmlNamespaceURI,  result); 

} 


static  void  pi (String  m)  { 
System. out . print In (m) ; 
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/ 


*  An  implementation  allowing  search  of  CCR  by  the  SystemName. 

*/ 

class  CCRSystemNameSearchHandler  implements  SearchHandler  { 

Collection  _resultCollection; 

String  _systemName; 

public  CCRSystemNameSearchHandler (String  systemName,  Collection  resultCollection)  { 
_resultCollection  =  resultCollection; 

_systemName  =  systemName; 

} 

public  boolean  carryOn ()  {  return  true;  } 

public  boolean  satisfied (Ob ject  obj)  { 
if  (obj==null)  return  false; 

CCR  ccr  =  (CCR) obj; 

return  ccr . getSystemName ( ) . equalsIgnoreCase (_systemName) ; 

} 

public  void  add (Object  obj)  { 

^resultCollection . add (ob j ) ; 


};  //  CCRSystemNameSearchHandler 
/** 

*  An  implementation  allowing  search  of  CCR  by  the  SystemName  and  NamespaceURI . 

*  There  can  be  at  most  one  matching  CCR. 

*  This  handler  is  only  applicable  within  a  FE . 

*/ 

class  CCRKeySearchHandler  implements  SearchHandler  { 
boolean  found=false; 

CCR [ ]  _result ; 

String  _systemName; 

URL  _xmlNamespaceURI ; 

String  _urlString; 

/** 

*  @param  systemName 

*  @param  xmlNamespaceURI 

*  @param  result  A  single  element  array  to  hold  the  result. 

*/ 

public  CCRKeySearchHandler (String  systemName,  URL  xmlNamespaceURI, 
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CCR [ ]  result)  { 


_systemName  =  systemName; 

_xmlNamespaceURI  =  xmlNamespaceURI ; 

_urlString  =  _xmlNamespaceURI . toString ( ) ; 

_result  =  result; 

_result[0]  =  null; 

} 

public  boolean  carryOn ()  {  return  ! found;  } 

public  boolean  satisfied (Ob ject  obj)  { 
if  (obj==null)  return  false; 

CCR  ccr  =  (CCR) obj; 

return  ccr . getSystemName ( ) . equalsIgnoreCase (_systemName)  && 

ccr . getXMLNameSpaceURI ( ) . equalsIgnoreCase (_urlString)  ; 

} 

public  void  add (Object  obj)  { 

_result[0]  =  (CCR) obj; 
found  =  true; 

} 

};  //  CCRSystemNameSearchHandler 

7.  FCRSchemalmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  java. util.*; 
import  java . lang . ref lect .* ; 
import  java . beans .* ; 

import  mil . navy . nps . cs . oomi .* ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


/** 

*  @author  LSC 

*  ©version  1.0 
*/ 

public  class  FCRSchemalmpl  extends  Schemalmpl 

implements  FCRSchema  { 
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/ 


*  The  list  of  top  level  attributes  of  this  schema. 

*/ 

List  _attributes  =  new  ArrayList (10) ; 

/** 

*  Public  no-arg  constructor  required  by  Castor  Unmarshaller . 
*/ 

public  FCRSchemalmpl ( )  { 

} 

) 

8.  FEImpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  java . util . Iterator ; 
import  java . util . ArrayList ; 
import  java . util . List ; 
import  java . util . Arrays ; 

import  java . net . URL; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  @author  LSC 

*  (Aversion  1.0 
*/ 

public  class  FEImpl  implements  FE  ( 

/** 

*  Name  of  this  FE . 

V 

protected  String  _feName  = 

/** 

*  The  FIOM  that  this  FE  belongs  to. 

*/ 
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private  FIOM  _fiom  =  null; 

/** 

*  The  FEV  of  this  FE . 

*/ 

protected  FEV  _rootFEV  =  null; 

/** 

*  The  parent  of  this  FE . 

*/ 

protected  FE  _parent  =  null; 

/** 

*  The  list  of  child  FEVs  of  this  FEV. 

*/ 

protected  List  _childList  =  new  ArrayListO; 


/** 

*  Public  access  required  for  restoration  using  Castor  Unmarshaller . 
*/ 

public  FEImplO  { 

} 


/** 

*  Creates  a  FEImpl  with  specified  name  that  belongs  to  the  specified  FIOM. 

*  Package-level  access  only. 

*/ 

FEImpl (FIOM  fiom,  FE  parent,  String  feName)  { 
setFIOM (f iom) ; 
setFEName (feName) ; 
setParent (parent)  ; 


/** 

*  Returns  the  FIOM  that  this  FE  belongs  to. 

*  ©return  Returns  the  FIOM  that  this  FE  belongs  to. 
*/ 

public  FIOM  getFIOM ( )  { 

return  _fiom; 


/** 

*  Sets  the  FIOM  that  this  FE  belongs  to. 
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*  should  only  be  called  from 

*  FIOMImpl . setFE ( )  during  restoration  from  storage, 

*  or  from  this  class's  constructor. 

*  therefore,  it  is  package-level  access. 

*/ 

void  setFIOM (FIOM  v)  { 

_fiom  =  v; 

} 


/** 

*  Gets  the  name  of  this  FE . 
*/ 

public  String  getFENameO  { 
return  _feName; 


/** 

*  Sets  the  name  of  this  FE . 

*  Public  access  required  for  restoration  from  storage. 
*/ 

public  void  setFEName (String  v)  { 

_feName  =  v; 

} 


public  FEV  getRootFEVO  { 
return  _rootFEV; 

} 

/** 

*  Sets  the  FEV  of  this  FE . 

*  Only  to  be  used  in  the  constructor  and 

*  to  restore  from  persistent  storage  by  Castor  Unmarshaller . 


*/ 

public  void  setRootFEV (FEV  v)  { 
_rootFEV  =  v; 

( (FEVImpl ) _rootFEV) . setFE (this) ; 

} 


public  FEV  findFEV(  String  fevName  )  { 

if  (  _rootFEV. getFEVName (). equalsIgnoreCase (fevName)  ) 
return  _rootFEV; 

return  _rootFEV. findDescendent (fevName,  true); 
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public  boolean  fevExists (String  fevName)  { 


return  findFEV (fevName) ! =null; 

} 


public  FEV  createRootFEV (String  fevName)  { 

_rootFEV  =  new  FEVImpl (  null,  this,  fevName  ); 
return  _rootFEV; 

} 


/** 

*  Equals  if  and  only  if  names  are  equal  and  getFIOM ( ) ==o . getFIOM ( ) . 
*/ 

public  boolean  equals (Object  o)  { 
if  (o  ==  null) 
return  false; 
if  (o  instanceof  FE)  { 

FE  fe  =  (FE) o; 

return  getFEName ( ) . equalsIgnoreCase (fe . getFEName ( ) )  && 
getFIOM ( ) ==fe . getFIOM ( )  ; 

//  cannot  use  getFIOM (). equals ( )  here, 

//  else  will  fall  into  infinite  loop 

} 

else 

return  false; 


public  FE  getParentO  { 
return  _parent; 

} 


/** 

*  Sets  the  parent  of  this  FE,  the  caller  is  responsible  for  updating  the 

*  child  list  of  the  parent. 

*  Private  access,  to  be  called  only  from 

*  FEImpl . setChild ( ) ,  FEImpl . createChild ( )  and  FEImpl . removeChild ( ) . 

*/ 

private  void  setParent (FE  parent)  { 

_parent  =  parent; 

} 


public  int  childCountO  { 
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return  _childList . size ( )  ; 


} 


public  FE [ ]  getChild ( )  { 

return  (FE [ ] ) _childList . toArray (  new  FE [  childCountO  ]  ); 


/** 

*  Sets  the  list  of  children  with  the  specified  array. 

*  Generally,  to  be  called  only  from  the  Castor  Unmarshaller . 
*/ 

public  void  setChild(  FE [ ]  v  )  { 

_childList . clear ( )  ; 

_childList . addAll (  Arrays . asList (v)  ); 

FEImpl  felmpl; 

for  (int  i=0;  i<v. length;  i++)  { 

felmpl  =  (FEImpl) (v[i]); 
felmpl . set Parent (this )  ; 
felmpl . setFIOM (this . getFIOM ( ) ) ; 

} 


public  FE  newChild (String  childFEName)  throws  DuplicateKeyException  { 
if  (hasDescendent (childFEName,  true) )  { 

throw  new  DuplicateKeyException (childFEName  +  "  already  exists."); 

} 

FEImpl  fe  =  new  FEImpl (this . getFIOM () ,  this,  childFEName); 

_childList . add (fe)  ; 
return  fe; 


public  boolean  hasDescendent (String  descendentName,  boolean  recurseTree)  { 
return  null  !=  findDescendent (descendentName,  recurseTree); 

} 


public  FE  findDescendent (String  descendentName,  boolean  recurseTree)  { 
FE [ ]  children  =  getChild (); 

FE  result; 

FE  curr; 

for  (int  i=0;  icchildren . length;  i++)  { 

curr  =  children [i] ; 

if  (curr . getFEName ( ) . equalsIgnoreCase (descendentName) ) 


return  curr; 
if  (recurseTree)  { 
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result  =  curr . f indDescendent (descendentName,  true); 
if  (result ! =null) 
return  result; 


return  null; 

} 

public  void  f indCCR (SearchHandler  handler)  { 
if  (getRootFEV ( ) !=null) 

getRootFEVO  .  f  indCCR  (handler)  ; 
if  (handler . carryOn  () ) 

findDescendentCCR (handler ) ; 

} 


public  void  findDescendentCCR (SearchHandler  handler)  { 
FE  [  ]  children  =  getChildO; 

FE  curr; 

for  (int  i=0;  i<children . length;  i++)  { 

curr  =  children [i] ; 
curr . f indCCR (handler) ; 

/* 

if  (handler .satisfied (curr . getRootFEV ( ) . getFCR ( ) ) ) 
handler . add (curr . getRootFEV ( ) . getFCR ( ) ) ; 
if  (handler . carryOn  () ) 

curr . findDescendentCCR (handler) ; 

*/ 


public  CCR [ ]  f indCCR (String  systemName)  { 

java . util . Set  resultSet  =  new  java . util . HashSet () ; 

f indCCR (  FCRImpl . makeCCRSystemNameSearchHandler (  systemName,  resultSet 
return  (CCR[])  result Set . toArray (new  CCR [ resultSet . size ()]) ; 

} 

public  CCR  f indCCR (String  systemName,  URL  xmlNameSpaceURI )  { 

CCR[]  result  =  new  CCR[1]; 

f indCCR (  FCRImpl . makeCCRKeySearchHandler (systemName,  xmlNameSpaceURI, 
return  result [0]; 

/* 

CCR  result  =  null; 
if  (getRootFEVO  !=null) 

result  =  getRootFEV (). f indCCR (systemName,  xmlNameSpaceURI); 
if  (result==null) 


result)  ) 
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return  f indDescendentCCR (systemName,  xmlNameSpaceURI ) ; 
else 

return  result; 

*/ 

} 

public  CCR  f indDescendentCCR (String  systemName,  URL  xmlNameSpaceURI)  { 
FE  [  ]  children  =  getChildO; 

CCR  result; 

FE  curr; 

for  (int  i=0;  i<children . length;  i++)  { 

curr  =  children [i]  ; 

result  =  curr . findCCR (systemName,  xmlNameSpaceURI); 
if  (result ! =null) 
return  result; 

} 

return  null; 

} 

} 

9.  FEVImpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  java . util . List ; 
import  java . util . Arrays ; 
import  java . util . Iterator ; 
import  java . util . ArrayList ; 
import  j ava . net . URL ; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  A  reference  implementation  of  a  Federation  Entity  View. 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  FEVImpl  implements  FEV  { 
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/** 

*  The  parent  of  this  FEV. 

*/ 

protected  FEV  _parent  =  null; 

/** 

*  The  list  child  FEVs  of  this  object. 

*/ 

protected  List  _childList  =  new  ArrayListO; 

/** 

*  The  name  of  this  FEV. 

*/ 

protected  String  _fevName  = 

/** 

*  The  FE  of  this  FEV. 

*/ 

protected  FE  „fe  =  null; 

/** 

*  The  FCR  corresponding  to  this  FEV. 

*/ 

protected  FCR  _fcr  =  null; 

/** 

*  Public  constructor  required  for  Castor  Marshal  and  Unmarshal. 
*/ 

public  FEVImpl ( )  { 

} 

/** 

*  Creates  an  FEVImpl  instance  with  the  specified  name  and  FE . 

*/ 

FEVImpl (  FEV  parent,  FE  fe.  String  fevName  )  { 

setFE  (fe) ; 

setFEVName (fevName) ; 
setParent (parent) ; 

) 


public  FCR  createFCR (String  fcrName)  ( 

FCR  result  =  new  FCRImpl (this ,  fcrName); 
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setFCR (result) ; 
return  result; 


public  String  getFEVNameO  { 
return  _fevName; 


/** 

*  Sets  the  name  of  this  FEV. 

*  Only  to  be  used  to  restore  this  object  from  persistent  storage. 
*/ 

public  void  setFEVName (String  v)  { 

_fevName  =  v; 

} 


public  FE  getFE()  { 
return  _fe; 

} 


/** 

*  Sets  the  FE  of  this  FEV. 

*  Only  to  be  used  in  the  constructor  and 

*  to  restore  this  object  from  persistent  storage. 
*/ 

public  void  setFE  (FE  fe)  { 

_fe  =  fe; 

} 


public  FOR  getFCR ( )  { 

return  _fcr; 

} 


/** 

*  Sets  the  FOR  of  this  FEV. 

*  To  be  used  in  the  constructor, 

*  Castor  Unmarshaller  and 

*  by  FEImpl . setFCR ( )  to  restore  this  object  from  persistent  storage. 
*/ 

public  void  setFCR (FCR  fcr)  { 

_fcr  =  fcr; 

( (FCRImpl ) _f cr ) . setFEV (this ) ; 
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public  FEV  getParentO  { 


return  _parent; 

} 


/** 

*  Sets  the  parent  of  this  FEV,  the  caller  is  responsible  for  updating  the 

*  child  list  of  the  parent. 

*  Private  access,  to  be  called  only  from 

*  FEVImpl . setChild ( ) ,  FEVImpl . createChild ( )  and  FEVImpl . removeChild ( ) . 

*/ 

private  void  setParent (FEV  parent)  { 

_parent  =  parent; 

} 


public  int  childCountO  { 
return  _childList . size ( )  ; 

} 


public  FEV [ ]  getChild ( )  { 

return  (FEV [ ] ) _childList . toArray (  new  FEV[  childCountO  ]  ); 

} 


/** 

*  Sets  the  list  of  children  with  the  specified  array. 

*  Sets  the  Parent  and  FE  properties  of  each  child  appropriately. 

*  Generally,  to  be  called  only  from  the  Castor  Unmarshaller . 

*/ 

public  void  setChild (  FEV [ ]  v  )  { 

_childList . clear ( )  ; 

_childList . addAll (  Arrays . asList (v)  ); 

FEVImpl  fevlmpl; 

for  (int  i=0;  i<v. length;  i++)  { 

fevlmpl  =  (FEVImpl) (v[i]); 
fevlmpl . setParent (this)  ; 
fevlmpl . setFE (this . getFE ( ) )  ; 

} 


/** 

*  Create  a  new  child  FEV  for  this  FEV  and  returns  the  newly  created  child. 

*  ©return  Returns  the  newly  created  child  FEV. 

*/ 
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public  FEV  newChild (String  childFEVName)  throws  DuplicateKeyException  { 


if  (hasDescendent (childFEVName,  true) )  { 

throw  new  DuplicateKeyException (childFEVName  +  "  already  exists."); 

} 

FEVImpl  fev  =  new  FEVImpl (this,  this . getFE ( ) ,  childFEVName); 
_childList . add (fev)  ; 
return  fev; 


public  boolean  hasDescendent (String  descendentName,  boolean  recurseTree)  { 
return  null  !=  findDescendent (descendentName,  recurseTree); 

} 


public  FEV  findDescendent (String  descendentName,  boolean  recurseTree)  { 
FEV  [  ]  children  =  getChildO; 

FEV  result; 

FEV  curr; 

for  (int  i=0;  icchildren . length;  i++)  { 

curr  =  children [i] ; 

if  (curr . getFEVName ( ) . equalsIgnoreCase (descendentName) ) 
return  curr; 
if  (recurseTree)  { 

result  =  curr . findDescendent (descendentName,  true); 
if  (result ! =null) 
return  result; 


return  null; 

} 


public  void  f indDescendentCCR (  SearchHandler  handler  )  { 

//  depth-first  search 

FEV  [  ]  children  =  getChildO; 

FEV  curr; 

for  (int  i=0;  icchildren . length  &&  handler . carryOn ()  ;  i++)  { 

curr  =  children [i] ; 
curr . f indCCR (handler)  ; 


public  void  f indCCR (SearchHandler  handler)  { 
if  (getFCR ( ) !=null) 

getFCRO  .  f  indCCR  (handler )  ; 
if  (handler . carryOn  () ) 
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findDescendentCCR (handler )  ; 


public  CCR [ ]  findCCR(  String  systemName  )  { 

java . util . HashSet  resultSet  =  new  java . util . HashSet () ; 

f indCCR (  FCRImpl . makeCCRSystemNameSearchHandler (systemName,  resultSet) 
return  (CCR[])  result Set . toArray (  new  CCR [ resultSet . size () ]  ); 

} 

public  CCR  f indCCR (String  systemName,  URL  xmlNameSpaceURI )  { 

CCR[]  result  =  new  CCR[1]; 

f indCCR (  FCRImpl . makeCCRKeySearchHandler (systemName,  xmlNameSpaceURI, 
return  result [0]; 

/* 

CCR  result  =  null; 
if  (getFCR ( ) !=null) 

result  =  getFCR (). f indCCR (systemName,  xmlNameSpaceURI); 
if  (result==null) 

return  findDescendentCCR (systemName,  xmlNameSpaceURI); 
else 

return  result; 

*/ 


public  CCR  findDescendentCCR (String  systemName,  URL  xmlNameSpaceURI)  { 
FEV  [  ]  children  =  getChildO; 

CCR  result; 

FEV  curr; 

for  (int  i=0;  icchildren . length;  i++)  { 

curr  =  children [i] ; 

result  =  curr . f indCCR (systemName,  xmlNameSpaceURI); 
if  (result ! =null) 
return  result; 

} 

return  null; 

} 


/** 

*  Equals  if  and  only  if  getFEVName ( ) . equalsIgnoreCase (o . getFEVName ( ) ) 

*  and  getFE ( ) ==o . getFE . 

*/ 

public  boolean  equals (Object  o)  { 
if  (o==null) 


result)  ) 
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return  false; 
if  (  o  instanceof  FEV  )  { 

FEV  fev  =  (FEV)  o; 

return  getFEVName (). equalsIgnoreCase ( fev . getFEVName () )  && 
getFE ( ) ==f ev. getFE  ( )  ; 


else 

return  false; 

) 


public  int  hashCodeO  { 

StringBuffer  sb  =  new  StringBuf fer ( ) ; 
if  (getFE ()! =null) 

sb. append (  getFE (). getFEName ( )  ); 
sb . append ("/ "  +  getFEVName ()) ; 

return  sb . toString ( ) . toLowerCase ( ) . hashCode ( ) ; 


10.  FIOMImpl.java 

package  mil . navy . nps . cs . oomi . impl ; 


import 

import 

import 

import 

import 

import 

import 

import 

import 

import 

import 


java . util . Array List ; 

java . util . Iterator; 

java . util . List ; 

java. util .Arrays; 

java . util . Collections; 

java . util . HashMap; 

java. util . HashSet; 

java. util . Set; 

j  ava .util. Map ; 

java . util . StringTokenizer; 

java . net . URL; 


import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 
import  mil . navy . nps . cs . oomi . * ; 

/** 


*  ©author  LSC 

*  ©version  1.0 
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/ 


public  class  FIOMImpl  implements  FIOM  { 

/** 

*  The  name  of  this  fiom. 

*/ 

protected  String  _fiomName  =  "" ; 

/** 

*  The  FEs  in  this  FIOM. 

*/ 

protected  List  _feList  =  new  ArrayListO; 

/** 

*  Holds  the  list  of  translations  known  to  this  FIOM. 

*  Each  entry  has  a  key  made  of  the  fully  qualified  name  of  the 

*  FCRInstance ' s  class  and  the  CCRInstance ' s  class,  separated  by  a  comma. 

*  Each  entry's  value  is  the  fully  qualified  class  name  of  the  specific 

*  descendent  of  AbstractTranslation . 

*/ 

protected  Map  _translationMap  =  new  HashMapO; 

/** 

*  The  factory  for  the  implementation  of  this  FIOM. 

*  This  field  is  initialised  whenever  a  new  instance  is  constructed. 

*/ 

protected  FIOMFactory  _factory  =  null; 

/** 

*  The  list  of  unregistered  OCRs  corresponding  to  this  FIOM. 

*/ 

protected  Set  _unregisteredCcrSet  =  new  HashSetO; 

/** 

*  Initialisation,  to  be  called  from  all  constructors. 

*/ 

private  void  init()  { 

_factory  =  Factorylmpl . factory () ; 

} 


/** 

*  Required  for  save/load  to/from  file. 
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V 

public  FIOMImpl ( )  { 

init  ()  ; 

} 


*  No  arguments  constructor  needed  for  Marshalling  by  Castor. 
*/ 

public  FIOMImpl (String  name)  { 
init  ()  ; 

_fiomName  =  name; 


public  String  getFIOMName ( )  { 

return  _fiomName; 

) 


/■** 

*  Sets  the  name  of  this  FIOM. 

*  Only  to  be  used  to  restore  this  object  from  persistent  storage. 
*/ 

public  void  setFIOMName (String  name)  ( 

_fiomName  =  name; 

} 


public  int  feCountO  { 
return  _f eList . size  ( ) ; 

) 


public  FE  [  ]  getFEO  { 

return  (FE []) _f eList . toArray (new  FE [ f eCount ( ) ] ) ; 

} 


/** 

*  Sets  the  array  of  FEs  in  this  FIOM,  used  to  restore  this  object  from 

*  persistent  storage.  Calls  setFIOMO  on  each  element  in  v. 

*  Sparam  v  The  array  of  FEs  to  be  set  for  this  FIOM,  each  element's 

*  fiom  property  is  set  to  this  object. 

*/ 

public  void  setFE(FE[]  v)  { 

_feList . clear  ( ) ; 

_feList . addAll (Arrays . asList  (v) ) ; 
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for  (int  i=0;  i<v. length;  i++)  { 

( (FEImpl)  v [i] ) . setFIOM (this) ; 


public  FE  findFE (String  feName)  { 

Iterator  iter  =  _f eList . iterator ()  ; 

FE  fe; 

while  (iter . hasNext ( ) )  { 

fe  =  (FE) iter . next () ; 

if  (  fe . getFEName (). equalsIgnoreCase (feName)  ) 
return  fe; 

} 

return  null; 


public  boolean  feExists (String  feName)  { 
return  findFE (feName)  !=  null; 

} 


public  FE  newFE (String  feName)  throws  DuplicateKeyException  { 
if  (  feExists (feName)  ) 

throw  new  DuplicateKeyException (feName  +  "  already  exists."); 
FEImpl  fe  =  new  FEImpl (  this,  null,  feName  ); 

_feList . add (fe) ; 
return  fe; 


public  CCR  findCCR (String  systemName,  URL  xmlNameSpaceURI )  { 

FE [ ]  feArray  =  getFE  ( ) ; 

CCR  result; 

for  (int  i=0;  i<feArray . length;  i++)  { 

result  =  feArray [i] . findCCR (systemName,  xmlNameSpaceURI); 
if  (result ! =null) 
return  result; 

} 

return  null; 


public  CCR  newCCR (String  systemName,  String  ccrName,  URL  xmlNameSpaceURI) 

throws  DuplicateKeyException 


if  (  ccrExists (systemName,  ccrName)  ) 

throw  new  DuplicateKeyException (ccrName  +  "  already  exists  for  system: 


+  systemName) 
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if  (  ccrExists (systemName,  xmlNameSpaceURI )  ) 

throw  new  DuplicateKeyException (xmlNameSpaceURI  +  "  already  exists  for  system 

systemName) ; 

//CCRImpl  ccr  =  new  CCRImpl (null,  systemName,  ccrName) ; 

CCR  ccr  =  factory () .makeCCR (null,  systemName,  ccrName); 
if  (  xmlNameSpaceURI ! =null) 

ccr . setXMLNameSpaceURI (  xmlNameSpaceURI . toString ( )  ); 

addUnregisteredCCR (ccr)  ; 
return  ccr; 

}//  CCR  newCCR (String,  String,  URL) 


public  void  registerCCR (FCR  fcr,  CCR  ccr)  { 
if  (_unregisteredCcrSet . contains (ccr ) )  { 

ccr . joinFCR (fcr) ; 

_unregisteredCcrSet . remove (ccr)  ; 


public  void  addUnregisteredCCR (  CCR  newCCR  )  { 

_unregisteredCcrSet . add (newCCR)  ; 

} 

public  CCR[]  getUnregisteredCCR (  )  { 

return  (CCR[])  _unregisteredCcrSet . toArray ( 

new  CCR [unregisteredCCRCount ( ) ]  ); 

} 

public  int  unregisteredCCRCount ( )  { 

return  _unregisteredCcrSet . size ( )  ; 


public  CCR  findUnregisteredCCR (String  systemName,  String  ccrName)  { 
Iterator  iter  =  _unregisteredCcrSet . iterator () ; 

CCR  ccr; 

while  (iter . hasNext ( ) )  { 

ccr  =  (CCR) iter .next ()  ; 

if  (  ccr . getSystemName (). equalsIgnoreCase (systemName)  && 
ccr . getCCRName ( ) . equalsIgnoreCase (ccrName)  ) 
return  ccr; 


return  null; 

} 

public  CCR  findUnregisteredCCR (String  systemName,  URL  xmlNameSpaceURI)  { 
if  (xmlNameSpaceURI==null) 
return  null; 
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Iterator  iter  =  _unregisteredCcrSet . iterator  () ; 

CCR  ccr ; 

String  urlString  =  xmlNameSpaceURI . toString ( ) ; 
while  (iter . hasNext ( ) )  { 

ccr  =  (CCR) iter .next ()  ; 

if  (  ccr . getSystemName ( ) . equalsIgnoreCase (systemName)  && 
ccr . getXMLNameSpaceURI ( ) . equals (urlString)  ) 
return  ccr; 

} 

return  null; 


public  boolean  ccrExists (String  systemName,  String  ccrName)  { 
return  findUnregisteredCCR (systemName,  ccrName) ! =null; 

} 

public  boolean  ccrExists (String  systemName,  URL  xmlNameSpaceURI)  { 
return  findUnregisteredCCR (systemName,  xmlNameSpaceURI )! =null; 

} 


public  boolean  equals (Object  o)  { 
if  (o==null) 
return  false; 
if  (o  instanceof  FIOM)  { 

FIOM  fiom  =  (FIOM)  o; 

if  ( ! getFIOMName ( ) . equalsIgnoreCase (f iom. getFIOMName ( ) ) ) 
return  false; 
else 

return  Arrays . equals (getFE () ,  fiom.getFE () )  ; 


else 

return 


false; 


public  void  addTranslation (  String  f crClassName,  String  ccrClassName, 

String  translationClassName  )  { 

_translationMap . put (  fcrClassName  +  +  ccrClassName, 

translationClassName  ) ; 

} 

public  String  f indTranslation (  String  fcrClassName,  String  ccrClassName  )  { 

String  result  =  (String) _translationMap . get (  fcrClassName  +  +  ccrClassName  ) 

if  (result==null) 
return  null; 
if  (result . length () ==0) 
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return  null; 


else 

return  result; 


/** 

*  For  use  by  Castor  Marshaller. 

*/ 

public  String []  getTranslations ( )  { 

String []  result  =  new  String [_translationMap . size ()] ; 

Set  entries  =  _translationMap . entrySet ( )  ; 

Iterator  iter  =  entries . iterator  () ; 

Map. Entry  entry; 
int  i  =  0; 

while  (iter . hasNext ( ) )  { 

entry  =  (Map.  Entry)  iter.nextO; 

result [i]  =  (String) entry . getKey ( )  +  "="  +  (String) entry . getValue ( ) 
i++; 

} 

return  result; 


/** 

*  For  use  by  Castor  Unmarshaller . 

*/ 

public  void  setTranslations (String [ ]  v)  { 
_translationMap . clear ( ) ; 

StringTokenizer  tokenizer; 

String  key; 

String  val; 

for  (int  i=0;  i<v. length;  i++)  { 

tokenizer  =  new  StringTokenizer (  v[i],  "="  ); 
if  (tokenizer . hasMoreTokens () ) 
key  =  tokenizer . nextToken () ; 
else 

continue; 

if  (tokenizer . hasMoreTokens () ) 
val  =  tokenizer . nextToken  () ; 
else 

continue; 

if  (key . length () ==0  ||  val . length () ==0 ) 
continue; 

_translationMap . put (  key,  val  ); 


public  FIOMFactory  factory ()  { 


return  _factory; 

} 


public  TypeName  makeTypeName (  String  typeName  )  { 

return  _f act ory .makeTypeName (typeName) ; 

} 

public  TypeName  makeTypeName (  Class  theClass  )  { 

return  _factory .makeTypeName (theClass)  ; 

} 

public  TypeName  makeArrayTypeName (  String  typeName,  int  dimensionCount  ) { 
return  _factory .makeArrayTypeName (typeName,  dimensionCount); 

} 

public  TypeName  makeArrayTypeName (  Class  theClass,  int  dimensionCount  ){ 
return  _factory .makeArrayTypeName (theClass,  dimensionCount); 

} 


static  void  p (String  m)  { 
System. out . print In (m) ; 

} 


11.  OOMIDatabaselmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 


import 

import 

import 

import 

import 


java . util . * ; 
java . io . FileWriter ; 
java . io . FileReader ; 
java . io . IOException; 
java . io . File; 


import 

import 

import 

import 


org . exolab . castor . xml . Marshal ler; 
org . exolab . castor . xml . Unmarshaller; 
org . exolab . castor . xml . Marshal Except ion; 
org . exolab . castor . xml . ValidationException; 


import  mil . navy . nps . cs . oomi . * ; 

import  mil . navy . nps . cs . oomi . exceptions . * ; 


159 


import  mil . navy . nps . cs . oomi . f iom. * ; 


/** 

*  A  default  implementation  of  OOMIDatabase . 

*  Relies  on  the  Castor  Marshaller  and  Unmarshaller  to  handle 

*  loading/saving  from/to  persistent  storage  (an  XML  file) . 

*  ©author  LSC 

*  ©version  1.0 
*/ 

public  class  OOMIDatabaselmpl  implements  OOMIDatabase  { 

/** 

*  The  list  of  FIOM's  in  this  database. 

*/ 

List  _fiomList  =  new  ArrayListO; 

/** 

*  This  class  should  only  be  instantiated  using 

*  <a  href="#saveToFile (String) ">  saveToFile (String  xmlFilename)  </a>. 
*/ 

public  OOMIDatabaselmpl ( )  { 

} 


/** 

*  Saves  this  OOMIDatabase  to  an  XML  file. 
*/ 


public  void  saveToFile (String  xmlFilename)  throws  IOException, 

ValidationException, 
MarshalException  { 

FileWriter  writer  =  new  FileWriter (xmlFilename) ; 

Marshaller . marshal (this,  writer) ; 

} 


/** 

*  Creates  a  new  OOMIDatabase  object  from  data  in  the  specified  XML  file. 

*  If  the  XML  file  does  not  exist,  the  returned  object  is 

*  set  to  default  values  that  represents  an  empty  database. 

*  ©param  xmlFilename  The  XML  file  where  the  data  is  stored. 

*  ©return  Returns  a  new  OOMIDatabase  with  content  restored  from  the  specified 
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XML  file.  If  the  XML  file  does  not  exist,  the  returned  object  is 
set  to  default  values  that  represents  an  empty  database. 


*/ 

public  static  OOMIDatabase  loadFromFile (String  xmlFilename) 

throws  IOException, 

ValidationException, 
MarshalException  { 


if  (new  File (xmlFilename) . exists () )  { 

FileReader  reader  =  new  FileReader (xmlFilename) ; 

return  (OOMIDatabase)  Unmarshaller . unmarshal (OOMIDatabaselmpl . class, 

} 

else 

return  new  OOMIDatabaselmpl  () ; 


public  int  fiomCountO  { 
return  _f iomList . size ( )  ; 

} 


public  FIOM [ ]  getFIOM ( )  { 

return  (FIOM[])  _f iomList . toArray (new  FIOM [ f iomCount ( ) ] ) ; 

} 


/** 

*  Sets  the  list  of  FIOM's  from  the  specified  value. 

*  For  use  by  the  persistence  storage  to  restore  this  object. 

*/ 

public  void  setFIOM(  FIOM[]  value  )  { 

_f iomList . clear ( )  ; 

_f iomList . addAll (Arrays . asList (value) )  ; 

} 

public  static  void  p (String  m)  { 

System. out . print In (m) ; 

} 

public  FIOM  newFIOM(  String  fiomName  )  throws  DuplicateKeyException  { 
FIOM  result  =  null; 
if  (fiomExists (fiomName) )  { 

throw  new  DuplicateKeyException (fiomName  +  "  already  exists."); 

} 

result  =  new  FIOMImpl (fiomName) ; 

_f iomList . add (result )  ; 
return  result; 


reader) 
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} 

public  boolean  fiomExists (  String  fiomName  )  { 

return  findFIOM (fiomName)  !=  null; 

} 


public  FIOM  findFIOM (  String  fiomName  )  { 

FIOM  result  =  null; 

Iterator  iter  =  _fiomList . iterator ()  ; 

FIOM  curr; 

while  (iter . hasNext ( ) )  { 

curr  =  (FIOM)  iter.nextO; 

if  (fiomName . equalsIgnoreCase (curr . getFIOMName ()) )  { 

result  =  curr; 
break; 


return  result; 

} 


public  boolean  equals (Object  o)  { 
if  (o  ==  null) 
return  false; 

if  (  o  instanceof  OOMIDatabaselmpl  )  { 

OOMIDatabaselmpl  db  =  (OOMIDatabaselmpl)  o; 
return  Arrays  .  equals  (  getFIOMO,  db.getFIOMO  ); 

} 

else 

return  false; 


12.  Schemalmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  java . util . List ; 
import  java . util . Arrays ; 
import  java . util . Iterator ; 
import  java . util . ArrayList ; 
import  java . util . WeakHashMap; 
import  java . util . Map; 
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import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


/** 

*  @author  LSC 

*  ©version  1 . 0 
*/ 

public  class  Schemalmpl  implements  Schema  { 

/** 

*  The  list  of  top  level  attributes  of  this  schema. 

*/ 

protected  List  _attributes  =  new  ArrayListO; 

/** 

*  A  cache  to  attempt  to  speed  up  f indAttribute ( ) . 

*/ 

private  Map  _attributeMap  =  new  WeakHashMap ( ) ; 

/** 

*  The  fully  qualified  name  of  the  class  that  this  schema  describes. 

*/ 

protected  TypeName  _type  =  null; 

/** 

*  Public  no-arg  constructor  needed  by  Castor  Unmarshaller . 

*/ 

public  Schemalmpl ()  { 

} 

public  TypeName  getTypeO  {  return  _type;  } 

public  void  setType (TypeName  type)  {  this._type  =  type;  } 

public  int  attributeCount ( )  {  return  ^attributes . size ( )  ;  } 

public  Attribute []  getAttribute ( )  { 

return  (Attribute [] )  _attributes . toArray (  new  Attribute [attributeCount () ]  ) 

} 

public  void  setAttribute (  Attribute []  value  )  { 
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_attributes . clear  ( ) ; 

_attributes . addAll (  Arrays . asList (value)  ); 

} 

public  void  addAttribute (  Attribute  attr  )  { 

_attributes . add (attr) ; 

} 

public  Attribute  addAttribute (  String  name,  TypeName  type  )  { 

Attribute  result  =  Factorylmpl . factory () .makeAttribute (  null,  name, 
_attributes . add (result ) ; 
return  result; 

} 

public  void  removeAttribute (  Attribute  attr  )  { 

//  remove  all  entries  in  the  cache 

_attributeMap . clear ( )  ; 

if  (  _attributes . contains (attr)  ) 

_attributes . remove (attr) ; 
else  { 

boolean  done  =  false; 

Iterator  i  =  _attributes . iterator () ; 

Attribute  curr; 

while  (i.hasNextO  &&  !done)  { 
curr  =  (Attribute) i . next ()  ; 
done  =  curr . removeDescendent (attr )  ; 


public  Attribute  f indAttribute (  Attribute  attr  )  { 

Iterator  i  =  _attributes . iterator () ; 

Attribute  curr; 

Attribute  c; 

while  (i.hasNextO)  { 

curr  =  (Attribute)  i . next ( ) ; 
if  (curr . equals (attr ) ) 
return  curr; 

c  =  curr . findDescendent (attr ) ; 
if  (c ! =null)  { 
return  c; 


return  null; 

} 

public  void  enumerateAttributes (  List  result  )  { 

Iterator  i  =  __attributes  .  iterator  ()  ; 


type  ) 
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Attribute  attr; 
while  (i . hasNext ( ) )  { 

attr  =  (Attribute)  i.next  ()  ; 
result . add (attr) ; 

attr . enumerateDescendents (  result  ); 

) 

} 

public  Attribute!]  enumerateAttributes (  )  { 

List  list  =  new  ArrayList  (20) ; 
enumerateAttributes  (list) ; 

return  (Attribute!])  list . toArray (  new  Attribute  [list . size  () ]  ) 


13.  TypeNamelmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  java . util . Set ; 
import  java . util . HashSet ; 
import  java . util . Arrays ; 

import  mil . navy . nps . cs . oomi . f iom. TypeName; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  TypeNamelmpl  implements  TypeName  { 

/** 


*  ©invariant  _typeName  !=  null 
*/ 

String  _typeName  = 

/** 

*  Public  no-argument  constructor  required  by  Castor. 
*/ 

public  TypeNamelmpl ( )  { 


165 


public  TypeNamelmpl (String  typeName)  { 


if  (typeName==null ) 
set TypeName ( " " ) ; 
else 

setTypeName (typeName) ; 


public  String  getTypeName ( )  {  return  _typeName;  } 

public  void  setTypeName (String  value)  { 
if  ( value==null ) 

_typeName  = 
else 

_typeName  =  value; 

} 


public  boolean  equals (Object  obj)  { 

return  toString (). equals (  ( (TypeName) obj ). toString ( )  ); 

} 

public  int  hashCodeO  { 

return  toString (). hashCode ()  ; 

} 

protected  final  char  ARRAY_INDICATOR  =  ' [ ' ; 
protected  final  char  CLASS_INDICATOR  =  '  L'; 
protected  final  Set  _primitiveTypes  =  new  HashSet(8); 

{ 

_primitiveTypes . addAll (  Arrays . asList (PRIMITIVE_NAMES)  ) 

} 

public  boolean  isArrayO  { 
if  (_typeName . length () ==0) 
return  false; 
else 

return  _typeName . charAt ( 0 ) ==ARRAY_I ND I C ATOR ; 

} 

public  boolean  isPrimitive ( )  { 

if  (_typeName . length () ==0) 
return  false; 
else  { 

if  (isArray ( ) ) 
return  false; 
else  { 

return  _primitiveTypes . contains (_typeName) ; 
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} 

} 

} 

public  String  toStringO  { 
return  _typeName; 

} 

public  TypeName  copy ( )  { 

return  Factorylmpl .  factory  ().  makeTypeName  (  toStringO  ); 

} 

protected  Object  clone  ()  { 

return  copy  ( ) ; 

} 


14.  ZzzTestAttributelmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  junit . framework . TestCase; 
import  java . util . List ; 
import  java . util . Arrays ; 
import  java . util . Iterator ; 
import  java . util . LinkedList ; 
import  java . util . ArrayList ; 

import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

public  class  ZzzTest_AttributeImpl  extends  TestCase 

{ 

FIOMFactory  _factory  =  Factorylmpl . newFIOMFactory () ; 

public  ZzzTest_AttributeImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_AttributeImpl (String  Name_) 

protected  void  setup () 

{ 

}  //protected  void  setup () 
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protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_AttributeImpl . class . getName ()} ; 
junit . swingui . TestRunner .main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

public  static  void  p (String  m)  { 

System. out . print In (m) ; 

} 


public  void  test_constructor_getset_Parent_Name_Type_l ( )  { 

Attribute  parent  =  new  Attributelmpl ( )  ; 

Attribute  attr  =  _factory .makeAttribute (parent ,  "The  name", 

_factory .makeTypeName ( "The  Type")  ); 

assertTrue (  parent . getParent ( )  ==  null 

&&  attr . getParent ( )  ==  parent 
&&  attr . getName (). equals ( "The  name") 

&&  attr . getType (). equals (_factory .makeTypeName ( "The  Type")) 

)  ; 


public  void  test_childCount_l ( )  throws  Exception  { 

Attribute  attr  =  ^factory .makeAttribute (  null,  "The  name",  _factory .makeTypeName ( "The 
Type")  ) ; 

attr . newChild (  "namel",  _factory .makeTypeName ( "type"  )  );//. newChild ( "namel- 

l",_factory .makeTypeName ("typel-1") ) ; 

attr . newChild (  "name2",  _factory .makeTypeName ( "type" )) ; 

assertEquals (  2,  attr . childCount ( )  ); 

} 


public  void  test_getChild_l ( )  throws  Exception  { 

Attribute  attr  =  _factory .makeAttribute (  null,  "The  name",  _factory .makeTypeName ( "The 
Type") ) ; 

Attribute []  attrs  =  new  Attribute []  {  attr . newChild (" 1 ", _factory .makeTypeName ("A") ) , 

attr . newChild ( "2  ", _factory . makeTypeName ("B") )  } ; 

assertTrue (  Arrays . equals (attrs,  attr . getChild ( ) )  ); 

} 

/** 

*  Calls  setChildO  once. 

*/ 
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public  void  test_setChild_l ( )  throws  Exception  { 

Attributelmpl  attr  =  (Attributelmpl)  _factory .makeAttribute (  null,  "The  name", 
.factory .makeTypeName ( "The  Type")  ); 

Attribute []  attrs  =  new  Attribute []  {  _factory .makeAttribute (  null, 

1 " , _f actory . makeTypeName ( "A" ) ) , 

_factory . makeAttribute (  null, 

2 ",_f actory .makeTypeName ("B")  )  }; 

attr . setChild (attrs) ; 

assertTrue (  Arrays . equals (attrs,  attr . getChild ( ) )  ); 


/** 

*  Calls  setChild ()  twice  to  ensure  replacement  by  the  second  call. 

*/ 

public  void  test_setChild_2 ( )  throws  Exception  { 

Attributelmpl  attr  =  (Attributelmpl)  _factory .makeAttribute (  null,  "The  name", 
.factory .makeTypeName ( "The  Type")  ); 

Attribute []  attrs  =  new  Attribute []  {  _f actory .makeAttribute (  null, 

1 " , _f actory . makeTypeName ( "A" )  ) , 

_factory .makeAttribute (  null, 

2 ",_f actory. makeTypeName ("B")  )  }; 

attr . setChild (attrs ) ; 
attr . setChild (attrs)  ; 

assertTrue (  Arrays . equals (attrs,  attr . getChild () )  ); 


/** 

*  Find  child,  should  not  match  with  itself. 

*/ 

public  void  test_f indChild_l ( )  throws  Exception  { 

Attribute  attr  =  _factory .makeAttribute (  null,  "The  name",  _f actory .makeTypeName ( "The 
Type")  ) ; 

Attribute  attr_l  =  attr . newChild (  "namel",  ^factory .makeTypeName ( "type" )) ; 

Attribute  attr_l_l  =  attr_l . newChild ( "namel-1 ", _f actory .makeTypeName ("typel-1") ) ; 

Attribute  attr_2  =  attr . newChild (  "name2",  ^factory .makeTypeName ( "type" )) ; 

Attribute  attr_3  =  attr . newChild (  "The  name",  _factory .makeTypeName ( "type" )) ; 
assertTrue  (  attr . f indChild (  "The  name"  )  ==  attr_3  ); 


/** 

*  Find  child,  should  not  find  grandchildren. 

*/ 

public  void  test_f indChild_2 ( )  throws  Exception  { 

Attribute  attr  =  _factory .makeAttribute (  null,  "The  name",  _f actory .makeTypeName ( "The 
Type") ) ; 

Attribute  attr_l  =  attr . newChild (  "namel",  ^factory .makeTypeName ( "type" )) ; 

Attribute  attr_l_l  =  attr_l . newChild ( "namel-1 ", _f actory .makeTypeName ("typel-1") ) ; 
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Attribute  attr_2  =  attr . newChild (  "name2",  _f actory . makeTypeName ( "type" ) ) ; 
Attribute  attr_3  =  attr . newChild (  "The  name",  _f actory . makeTypeName ( "type" )) ; 
assertTrue (  attr . f indChild (  "namel-1"  )  ==  null  ); 


/** 

*  Find  descendent . 

*/ 

public  void  test_f indDescendent_Attribute_l ( )  throws  Exception  { 


Attribute 
Type" ) ) ; 

Attribute 

Attribute 

Attribute 

Attribute 

Attribute 


attr  =  _factory .makeAttribute {  null,  "The  name",  _factory .makeTypeName ( "The 

attr_l  =  attr . newChild (  "namel",  _f actory . makeTypeName ( "type" )) ; 
att r_l_l  =  att r_l . newChild ( "namel-1 " , _f actory . makeTypeName ( "typel-1 " ) )  ; 
attr_2  =  attr . newChild (  "name2",  _f actory . makeTypeName ( "type" )) ; 
attr_3  =  attr . newChild (  "The  name",  _f actory . makeTypeName ( "type" )) ; 
attr_4  =  attr . newChild (  "The  name  4",  _f actory . makeTypeName ( "type" )) ; 


Attribute 
Type" ) ) ; 

Attribute  a. 

Attribute  a. 

Attribute  a. 

Attribute  a. 

Attribute  a. 

assertTrue ( 


a  =  _f actory . makeAttribute (  null,  "The  name",  _factory .makeTypeName ( "The 

_1  =  a.newChild(  "namel",  _f actory . makeTypeName ( "type" ))  ; 

_1_1  =  a_l . newChild ( "namel-1 " , _f actory . makeTypeName ( "typel-1 " ) ) ; 

_2  =  a.newChild(  "name2",  _f actory . makeTypeName ( "type" )) ; 

_3  =  a.newChild(  "The  name",  _f actory . makeTypeName ( "type" ))  ; 

_4  =  a.newChild(  "The  name  4",  _f actory . makeTypeName ( "type" )) ; 
attr_4  ==  attr . findDescendent (  a_4  )  ); 


/ 


*  Find  descendent. 


*/ 

public  void  test_f indDescendent_Attribute_2 ( ) 

Attribute  attr  =  _factory .makeAttribute ( 
Type") ) ; 

Attribute 

Attribute 

Attribute 

Attribute 

Attribute 


throws  Exception  { 

null,  "The  name",  _factory .makeTypeName ( "The 


attr_l  =  attr . newChild (  "namel",  __factory  .makeTypeName  (  "type"  ))  ; 
attr_l_l  =  attr_l . newChild ( "namel-1 ", _f actory .makeTypeName ("typel-1") ) ; 
attr_2  =  attr . newChild (  "name2",  __factory  .makeTypeName  ( "type"  ))  ; 
attr_3  =  attr . newChild (  "The  name",  ^factory .makeTypeName ( "type" )) ; 
attr_4  =  attr . newChild (  "The  name  4",  _f actory .makeTypeName ( "type" )) ; 


Attribute 
Type") ) ; 

Attribute 

Attribute 

Attribute 

Attribute 

Attribute 


a  =  _f actory . makeAttribute (  null,  "The  name",  _factory .makeTypeName ( "The 

a_l  =  a. newChild (  "namel",  _factory .makeTypeName ( "type" )) ; 
a_l_l  =  a_l . newChild ( "namel-1 ",_f actory .makeTypeName ("typel-1") ) ; 
a_2  =  a. newChild (  "name2",  _factory .makeTypeName ( "type" )) ; 
a_3  =  a.newChild(  "The  name",  _factory .makeTypeName ( "type" )) ; 
a_4  =  a. newChild (  "The  name  4",  _f actory .makeTypeName ( "type" )) ; 
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//assertTrue (  attr_l_l  ==  attr . f indDescendent (  a_l  )  ); 
assertlrue (  attr_l_l  ==  attr . f indDescendent (  a_l_l  )  ); 


/** 

*  Find  descendent . 


*/ 

public  void  test_f indDescendent_Attribute_3 ( ) 

Attribute  attr  =  _factory .makeAttribute ( 
Type" ) ) ; 

Attribute 

Attribute 

Attribute 

Attribute 

Attribute 


throws  Exception  { 

null,  "The  name",  _factory .makeTypeName ( "The 


attr_l  =  attr . newChild (  "namel",  _factory . makeTypeName ( "type" )) ; 
att r_l_l  =  att r_l . newChild ( "namel-1 " , _f actory . makeTypeName ( "typel-1 " ) ) ; 
attr_2  =  attr . newChild (  "name2",  _f actory . makeTypeName ( "type" )) ; 
attr_3  =  attr . newChild (  "The  name",  _f actory . makeTypeName ( "type" )) ; 
attr_4  =  attr . newChild (  "The  name  4",  _f actory . makeTypeName ( "type" )) ; 


Attribute 
Type" ) ) ; 

Attribute 

Attribute 

Attribute 

Attribute 

Attribute 

assertTrue 


a  =  _f actory . makeAttribute (  null,  "The  name",  _f actory .makeTypeName (" The 

a_l  =  a.newChild(  "namel",  _f actory . makeTypeName ( "type" )) ; 

a_l_l  =  a_l . newChild ( "namel-1 " , _f actory . makeTypeName ( "typel-1 " ) ) ; 

a_2  =  a.newChild(  "name2",  _f actory . makeTypeName ( "type" )) ; 

a_3  =  a.newChild(  "The  name",  _f actory . makeTypeName ( "type" )) ; 

a_4  =  a.newChild(  "The  name  4  not  found",  _f actory . makeTypeName ( "type" )) ; 

(  attr . f indDescendent (  a_4  )  ==  null  ); 


/** 

*  Tests  that  copyO  properly  copies  the  ancestors. 

*/ 

public  void  test_copy_l ( )  throws  Exception  ( 

Attribute  attr  =  _factory .makeAttribute {  null,  "The  name",  _factory .makeTypeName ( "The 
Type" ) ) ; 

Attribute  attr_l  =  attr . newChild (  "namel",  _f actory . makeTypeName ( "type" )) ; 

Attribute  attr_l_l  =  att r_l . newChild ( "namel-1 ", _f actory . makeTypeName ( "typel-1 ")) ; 

Attribute  attr_2  =  attr . newChild (  "name2",  _f actory . makeTypeName ( "type" )) ; 

Attribute  attr_3  =  attr . newChild (  "The  name",  _f actory . makeTypeName ( "type" )) ; 

Attribute  attr_4  =  attr . newChild (  "The  name  4",  _f actory . makeTypeName ( "type" )) ; 
assertTrue (  attr . copy (). equals (  attr  )  &&  attr_4 . copy (). equals (attr_4 )  ); 

} 

/** 

*  Tests  that  copyO  properly  copies  the  descendents. 

V 

public  void  test_copy_2 ( )  throws  Exception  ( 

Attribute  attr  =  _factory .makeAttribute (  null,  "The  name",  _factory .makeTypeName ( "The 
Type" ) ) ; 

attr. setMinOccurs (100)  ; 
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attr . setMaxOccurs  (200) ; 

Attribute  attr_l  =  attr . newChild (  "namel",  _factory .makeTypeName ( "type" ) ) ; 

Attribute  attr_l_l  =  attr_l .newChild ( "namel-1 " , _f actory .makeTypeName ("typel-l") ) ; 
attr_l_l . setMinOccurs (10)  ; 
attr_l_l . setMaxOccurs (20)  ; 

Attribute  attr_2  =  attr . newChild (  "name2",  _factory .makeTypeName ( "type" )) ; 

Attribute  attr_3  =  attr . newChild (  "The  name",  _factory .makeTypeName ( "type" )) ; 

Attribute  attr_4  =  attr . newChild (  "The-name-4 " ,  _factory .makeTypeName ( "type" )) ; 

Attribute  clone  =  attr. copy (); 

Attribute  clone_l_l  =  clone . findDescendent (attr_l_l ) ; 

Attribute  clone_3  =  clone . findDescendent (attr_3) ; 

assertTrue (  clone_l_l ! =attr_l_l 

&&  clone . childCount () ==4 
&&  clone_l_l . equals (attr_l_l ) 

&&  clone_l_l . getParent ( ) . equals (attr_l ) 

&&  attr_4 . childCount () ==0 

&&  clone . getMinOccurs ( )  ==  attr . getMinOccurs ( ) 

&&  clone . getMaxOccurs ( )  ==  attr . getMaxOccurs ( ) 

&&  clone_l_l . getMinOccurs ( )  ==  attr_l_l . getMinOccurs ( ) 

&&  clone_l_l . getMaxOccurs ( )  ==  attr_l_l . getMaxOccurs ( ) 

&&  clone_3 . getMinOccurs ( )  ==  attr_3 . getMinOccurs ( ) 

&&  clone_3 . getMaxOccurs ( )  ==  attr_3 . getMaxOccurs ( ) 

)  ; 


/** 

*  Duplicate  attribute  name. 

*/ 

public  void  test_newChild_l ( )  throws  Exception  { 
try  { 

Attribute  attr  =  _factory .makeAttribute (  null,  "The  name",  _f actory .makeTypeName ( "The 
Type") ) ; 

attr . newChild (  "namel",  _f actory .makeTypeName  (  "type" ) )  . newChild ( "namel- 

l",_f actory .makeTypeName ("typel-l") ) ; 

attr . newChild (  "name2",  _factory .makeTypeName ( "type" )) ; 

attr . newChild (  "name2",  _factory .makeTypeName ( "type" )) ; 

fail (  UniqueNameViolat ionException . class . getName ( )  + 

"  expected  but  not  thrown."  ); 


catch  (Exception  exc)  { 

assertEquals (  UniqueNameViolationException . class,  exc . getClass ( )  ); 


/** 

*  Duplicate  attribute  name  in  grandchild. 
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no  exceptions  should  be  encountered. 


V 

public  void  test_newChild_2 ( )  throws  Exception  { 
try  { 

Attribute  attr  =  _f actory . makeAtt ribute (  null,  "The  name",  _f actory . makeTypeName ( "The 
Type" ) ) ; 

attr . newChild {  "namel",  _f actory .makeTypeName ( "type ") ) .  newChild ( "namel- 

l",_f actory .makeTypeName ("typel-1") )  ; 

attr . newChild {  "name2",  _f actory .makeTypeName ( "type ")). newChild (  "name2", 

_f actory . makeTypeName ( "type" ) )  ; 

assertTruel  true  ); 

} 

catch  (UniqueNameViolationException  exc)  { 

fail (  UniqueNameViolationException . class . getName ( )  + 

"  thrown . "  )  ; 


/** 

*  newChild (),  tests  Parent  set. 

*/ 

public  void  test_newChild_3 ( )  throws  Exception  { 

Attribute  parent  =  _f actory . makeAtt ribute (  null,  "The  name",  _f actory . makeTypeName ( "The 
Type" ) ) ; 

Attribute  child  =  parent . newChild (  "namel",  _f actory . makeTypeName ( "type" )) ; 
assertTrue (  parent  ==  child . getParent ( )  ); 


/** 

*  Test  the  set/get  of  minOccurs,  maxOccurs . 

*/ 

public  void  test_getset_minOccurs_maxOccurs ( )  ( 

Attribute  attr  =  new  Attributelmpl ( ) ; 
attr . setMinOccurs ( 1 )  ; 
attr . setMaxOccurs ( 10 )  ; 
assertTrue (  attr . getMinOccurs ( ) ==1  && 
attr . getMaxOccurs ( ) ==10  ); 


/** 

*  Tests  isMandatory ( ) . 

*  getMinOccurs ( )  ==  1 
*/ 

public  void  test_isMandatory_l_true ( )  ( 

Attribute  attr  =  new  Attributelmpl () ; 
attr . setMinOccurs  ( 1 ) ; 
attr . setMaxOccurs  ( 10 ) ; 
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assertTrue (  attr . isMandatory ( )  ); 


/** 

*  Tests  isMandatory () . 

*  getMinOccurs ( )  >  1 
*/ 

public  void  test_isMandatory_2_true ( )  ( 

Attribute  attr  =  new  Attributelmpl ( ) ; 
attr. setMinOccurs (2)  ; 
attr . setMaxOccurs ( 10 )  ; 
assertTrue (  attr . isMandatory ( )  ); 


/** 

*  Tests  isMandatory () . 

*/ 

public  void  test_isMandatory_l_f alse ( )  ( 

Attribute  attr  =  new  Attributelmpl () ; 
attr. setMinOccurs  (0) ; 
attr . setMaxOccurs  ( 10 ) ; 
assertTrue  (  ! attr . isMandatory ( )  ); 


/** 

*  Tests  isArrayO. 

*/ 

public  void  test_isArray_l_true ( )  ( 

Attribute  attr  =  _factory .makeAttribute {  null,  "abc",  _factory .makeArrayTypeName ( "def "  ,  1 ) 

attr . setMinOccurs ( 1 )  ; 
attr . setMaxOccurs ( 10 )  ; 
assertTrue (  attr . isArray ( )  ); 


/** 

*  Tests  isArrayO.  getMaxOccurs ( ) >1 . 

*/ 

public  void  test_isArray_l_f alse ( )  ( 

Attribute  attr  =  _factory . makeAttribute (  null,  "abc",  _f actory . makeTypeName ( "def " )  ); 

attr . setMinOccurs ( 1 ) ; 
attr. setMaxOccurs (2)  ; 
assertTrue (  ! attr . isArray ( )  ); 

} 


public  void  test_equals_l ( )  { 

Attribute  attrl  =  new  Attributelmpl (null,  "name",  _f actory . makeTypeName ( "type" )) ; 
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Attribute  attr2  =  new  Attributelmpl (null,  "name",  _f actory .makeTypeName ( "type" ) ) ; 

Attribute  attr3  =  new  Attributelmpl (null,  "name",  _factory .makeTypeName ( "typel ")) ; 

assertTrue (  attrl . equals (attr2 )  &&  ! attrl . equals (attr3)  )  ; 

} 

public  void  test_equals_2 ( )  { 

Attribute  commonParent  =  new  Attributelmpl (null,  "parent", 

factory. makeTypeName ("typel") ) ; 

Attribute  attrl  =  new  Attributelmpl (commonParent ,  "name",  _factory .makeTypeName ( "type" )) ; 

Attribute  attr2  =  new  Attributelmpl (commonParent ,  "name",  _factory .makeTypeName ( "type" )) ; 

Attribute  attr3  =  new  Attributelmpl (null,  "name",  _f actory .makeTypeName ( "type" )) ; 

assertTrue (  attrl . equals (attr2 )  &&  ! attrl . equals (attr3) ) ; 

} 

public  void  test_equals_3 ( )  { 

Attribute  parentl  =  new  Attributelmpl (null,  "parent",  __factory .makeTypeName ( "typel ")) ; 
Attribute  parent2  =  new  Attributelmpl (null,  "parent",  __factory .makeTypeName ( "typel ")) ; 
Attribute  attrl  =  new  Attributelmpl (parent 1 ,  "name",  _factory .makeTypeName ( "type" )) ; 
Attribute  attr2  =  new  Attributelmpl (parent2 ,  "name",  _factory .makeTypeName ( "type" )) ; 
assertTrue (  attrl . equals (attr2 )  ); 

} 

public  void  test_equals_4 ( )  { 

Attribute  parentl  =  _factory .makeAttribute ( 

.factory . makeAttribute (null, "grandparent " , _f actory . makeTypeName ( "grandparent " ) ) , 

"parent",  _f actory .makeTypeName ( "typel " ) ) ; 

Attribute  parent2  =  _factory .makeAttribute ( 

.factory . makeAttribute (null, "grandparent " , _f actory . makeTypeName ( "grandparent " ) ) , 

"parent",  _f actory .makeTypeName ( "typel " ) ) ; 

Attribute  attrl  =  _factory .makeAttribute (parentl,  "name",  _factory .makeTypeName ( "type" )) ; 
Attribute  attr2  =  _factory .makeAttribute (parent2,  "name",  _f actory .makeTypeName ( "type" )) ; 
assertEquals (  attrl,  attr2  )  ; 

} 

public  void  test_equals_5 ( )  { 

Attribute  parent2  =  _factory .makeAttribute ( 

factory . makeAttribute (null, "grandparent " , _f actory . makeTypeName ( "grandparent " ) )  , 

"parent",  _f actory .makeTypeName ( "typel " ) ) ; 

Attribute  attrl  =  _factory .makeAttribute (null,  "name",  _factory .makeTypeName ( "type" )) ; 
Attribute  attr2  =  _factory .makeAttribute (parent2,  "name",  _f actory .makeTypeName ( "type" )) ; 
assertTrue (  ! attrl . equals (attr2 )  ); 

} 

public  void  test_equals_6 ( )  { 

Attribute  parentl  =  _factory .makeAttribute ( 

.factory . makeAttribute (null, "grandparent " , _f actory . makeTypeName ( "grandparent " ) ) , 
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"parentAb",  _factory .makeTypeName ( "typel " ) ) ; 

Attribute  parent2  =  _factory .makeAttribute ( 

factory . makeAttribute (null, "grandparent " , _f actory . makeTypeName ( "grandparent " ) )  , 

"parent",  _f actory .makeTypeName ("typel") ) ; 

Attribute  attrl  =  _factory .makeAttribute (parentl,  "name",  _factory .makeTypeName ( "type" )) ; 
Attribute  attr2  =  _factory .makeAttribute (parent2,  "name",  _f actory .makeTypeName ( "type" )) ; 
assertTrue (  ! attrl . equals (attr2 )  ); 


/** 

*  Attributes  with  different  child  attributes  can  be  equal. 

*/ 

public  void  test_equals_7 ( )  { 

Attribute  parentl  =  _factory .makeAttribute ( 

factory . makeAttribute (null, "grandparent " , _f actory . makeTypeName ( "grandparent " ) )  , 

"parent",  _f actory .makeTypeName ("typel") ) ; 

Attribute  parent2  =  _factory .makeAttribute ( 

factory . makeAttribute (null, "grandparent " , _f actory . makeTypeName ( "grandparent " ) ) , 

"parent",  _f actory .makeTypeName ("typel") ) ; 

Attribute  attrl  =  _factory .makeAttribute (parentl,  "name",  _factory .makeTypeName ( "type" )) ; 

Attribute  attrl_l  =  _factory .makeAttribute (attrl,  "abc",  _factory .makeTypeName ( "type" )) ; 

Attribute  attr2  =  _factory .makeAttribute (parent2,  "name",  _f actory .makeTypeName ( "type" )) ; 

Attribute  attr2_l  =  _f actory . makeAttribute  (attr2 ,  "name2", 

f actory. makeTypeName ("type2") ) ; 

assertTrue (  ! attrl_l . equals (attr2_l )  &&  attrl . equals (attr2)  ); 

} 

public  void  test_fullpath_l ( )  { 

FIOMFactory  f  =  _factory; 

Attribute  pi  =  f .makeAttribute (  null,  "Parentl",  f .makeTypeName ( "t" )) ; 

Attribute  p2  =  f .makeAttribute (  pi,  "Parent2",  f .makeTypeName ( "t" )) ; 
assertEquals (  "Parentl",  pi . fullPath ( )  ); 

} 

public  void  test_fullpath_2 ( )  { 

FIOMFactory  f  =  _factory; 

Attribute  pi  =  f .makeAttribute (  null,  "Parentl",  f .makeTypeName ( "t" )) ; 

Attribute  p2  =  f .makeAttribute (  pi,  "Parent2",  f .makeTypeName ( "t" )) ; 
assertEquals (  "Parent 1 . Parent2 " ,  p2 . fullPath ( )  ); 


public  void  test_ancestors_l ( )  { 

FIOMFactory  f  =  _factory; 

Attribute []  a  =  new  Attribute [3] ; 

a[0]  =  f .makeAttribute (  null,  "AttrO",  f .makeTypeName ( "t" )) ; 
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a [ 1 ]  =  f .makeAttribute (  a [ 0 ] ,  "Attrl",  f . makeTypeName ( "t " ) ) ; 
a [2]  =  f .makeAttribute (  a [ 1 ] ,  "Attr2",  f . makeTypeName ( "t ")) ; 

assertlrue (  Arrays . equals (  a,  a [2 ] . pathToArray ( )  )  && 
a [0 ] .pathToAr ray (). length  ==  1  ) ; 


}  //public  class  ZzzTest_AttributeImpl  extends  TestCase 

15.  ZzzTestCCRImpl.java 

package  mil . navy . nps . cs . oomi . impl ; 


import  java. util.*; 

import  java.io.*; 

import  junit . framework . TestCase; 

import  mil . navy . nps . cs . oomi .* ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


public  class  ZzzTest_CCRImpl  extends  TestCase 

{ 


FIOMFactory  fiomFactory  =  Factorylmpl . newFIOMFactory ( ) ; 

public  ZzzTest_CCRImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_CCRImpl (String  Name_) 


protected  void  setup ()  throws  Exception 

{ 

}  //protected  void  setup () 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_CCRImpl . class . getName () } 
junit . swingui . TestRunner .main (testCaseName) ; 
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}  //public  static  void  main (String [ ]  args) 


/** 

*  Tests  the  constructor  and  get/set  FCR  and  CCRName. 
*/ 


public  void  test_constructor_getset_FCR_CCRName ( )  ( 

FCR  fcr  =  new  FCRImplO; 

CCR  ccr  =  new  CCRImpl (  fcr,  "System",  "The  CCR  name" 
assertTruel  ccr.getFCRO  ==  fcr  && 

ccr . getCCRName ( ) .equals!  "The  CCR  name"  ) 


)  ; 


public  void  test_getset_CCRSchema_l ( )  ( 

CCRImpl  ccr  =  new  CCRImpl (  null,  "System",  "The  Name"); 

CCRSchema  newCcrSchema  =  new  CCRSchemalmpl ( ) ; 
ccr . setCCRSchema (newCcrSchema)  ; 

assertTruel  ccr . getCCRSchema ( )  ==  newCcrSchema  ); 

) 

public  void  test_getset_javaClassName_xmlNameSpaceURI_l ( )  { 

CCR  ccr  =  new  CCRImpl (  null,  "System",  "The  Name"); 
ccr . set JavaClassName (  "a.c.d.f"  ); 

ccr . setXMLNameSpaceURI (  "http://abc.com/xsd/abc.xsd"  ); 
assertTruel  "a . c . d . f ". equals (ccr . get JavaClassName () )  && 

"http : //abc . com/xsd/abc . xsd" . equals (ccr . getXMLNameSpaceURI ( ) )  )  ; 


public  void  test_getset_SystemName_l ( )  ( 

CCR  ccr  =  new  CCRImpl (  null,  "SystemName" ,  "The  Name"); 
ccr . set JavaClassName (  "a.c.d.f"  ); 

ccr . setXMLNameSpaceURI (  "http://abc.com/xsd/abc.xsd"  ); 
assertTruel  "SystemName" . equals (ccr . getSystemName () )  && 
"The  Name" . equals (ccr . getCCRName () )  ); 


public  void  test_isMandatoryFCRAttribute_l ( )  ( 

FIOMFactory  f  =  fiomFactory; 

CCRImpl  ccr  =  new  CCRImpl (  null,  "SystemName",  "The  Name"); 

CCRSchema  schema  =  ccr . getCCRSchema () ; 

Attribute  attrl  =  schema . addAttribute (  "nameAA",  fiomFactory . makeTypeName ( "theType" )  ) 

attrl . setMinOccurs ( 1 ) ; 

Attribute  attr2  =  schema . addAttribute (  "nameAl",  fiomFactory . makeTypeName ( "theType" )  ) 

Attributed  fcrAttrsl 

=  (  f . makeAtt ribute (  null,  "FCR_nameAA_l " ,  f . makeTypeName ( "theType" )  ), 
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f .makeAt tribute (  null,  "FCR_nameAA_2 " ,  f .makeTypeName ( "theType" )  ) 

} ; 

ccr . addFCRToCCRAttributeMapping ( 
f crAttrsl , 

f .makeAttribute (null,  "nameAA",  fiomFactory .makeTypeName ( "theType" ) )  ); 

//  "duplicate"  mandatory  attributes  to  ensure  the  count  is  correct 
Attribute []  fcrAttrsla 

=  {  f .makeAttribute (  null,  "FCR_nameAA_l " ,  f .makeTypeName ( "theType" )  ), 

f .makeAttribute (  null,  "FCR_nameAA_2 " ,  f .makeTypeName ( "theType" )  ) 

} ; 

ccr . addFCRToCCRAttributeMapping ( 
fcrAttrsla, 

f .makeAttribute (null,  "nameAA",  fiomFactory .makeTypeName ( "theType" ) )  ); 

Attribute []  fcrAttrs2 

=  {  f .makeAttribute (  null,  "FCR_nameAA_l_2 " ,  f .makeTypeName ( "theType" )  ), 

f .makeAttribute (  null,  "FCR_nameAA_2_2 " ,  f .makeTypeName ( "theType" )  ) 

} ; 

ccr . addFCRToCCRAttributeMapping (  fcrAttrs2,  attr2.copy()  ); 

Attribute  a  =  f .makeAttribute (null,  f crAttrsl [ 0 ]. getName () , 

f .makeTypeName (fcrAttrsl [ 0 ] . getType ( ) . toString ( ) ) ) ; 
Attribute  b  =  f .makeAttribute (null,  f crAttrsl [ 1 ]. getName () , 

f .makeTypeName (fcrAttrsl [ 1 ]  . getType ( )  . toString ( ) ) )  ; 
assertTrue (  ccr .mandatoryFCRAttributeCount ( ) ==2  && 
ccr . isMandatoryFCRAttribute (a)  && 
ccr . isMandatoryFCRAttribute (b)  && 

! ccr . isMandatoryFCRAttribute (fcrAttrs2 [ 0 ] . copyO)  && 

! ccr . isMandatoryFCRAttribute (fcrAttrs2 [ 1 ] . copy ( ) ) 

)  ; 

} 

public  void  test_isMandatoryFCRAttribute_2 ( )  { 

CCRImpl  ccr  =  new  CCRImpl (  null,  "SystemName" ,  "The  Name"); 

assertTrue (  ! ccr . isMandatoryFCRAttribute (fiomFactory .makeAttribute (null,  "name" , 

fiomFactory .makeTypeName ( "theType" ) )  ) ) ; 

} 

public  void  test_compareTo_l ( )  { 

CCRImpl  ccrl  =  new  CCRImpl (  null,  "SystemName",  "The  Name"); 

CCRImpl  ccr2  =  new  CCRImpl (  null,  " SystemName2 " ,  "1"); 
assertTrue (  ccrl . compareTo (ccr2 )  <0  ); 

} 

public  void  test_compareTo_2 ( )  { 

CCRImpl  ccrl  =  new  CCRImpl (  null,  "SystemName",  "The  Name"); 
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CCRImpl  ccr2  =  new  CCRImpl (  null,  "SystemName 
assertTrue (  ccrl . compareTo (ccr2 ) ==0  ); 


The  Name"); 


public  void  test_compareTo_3 ( )  { 

CCRImpl  ccrl  =  new  CCRImpl (  null,  "SystemName",  "The  Name"); 

CCRImpl  ccr2  =  new  CCRImpl (  null,  "A",  "The  Name"); 

assertTrue (  ccrl . compareTo (ccr2 ) >0  ); 

} 

public  void  test_compareTo_4 ( )  { 

CCRImpl  ccrl  =  new  CCRImpl (  null,  "SystemName",  "The  Name"); 

CCRImpl  ccr2  =  new  CCRImpl (  null,  "SystemName",  "A"); 

assertTrue  (  ccrl . compareTo (ccr2 ) >0  ); 


public  void  test_compareTo_5 ( )  { 

CCRImpl  ccrl  =  new  CCRImpl (  null,  "SystemName",  "The  Name"); 
CCRImpl  ccr2  =  new  CCRImpl (  null,  "SystemName",  "X") ; 
assertTrue  (  ccrl . compareTo (ccr2 ) <0  ); 


public  void  test_joinCCR_l ( )  { 

CCRImpl  ccr  =  (CCRImpl)  f iomFactory . makeCCR (  null,  "S",  "T_CCR" 
FCRImpl  for  =  new  FCRImpl (  null,  "FCR"  ); 
ccr . joinFCR (f cr) ; 

assertTrue  (  ccr . getFCR ( ) ==f cr  &&  fcr . f indCCR ( "S" , "T_CCR" ) ==ccr  ) 

} 


public  static  void  p (String  m)  { 

System. out . print In (m) ; 

} 

}  //public  class  ZzzTest_CCRImpl  extends  TestCase 

16.  ZzzTestFactorylmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  junit . framework . TestCase; 
import  mil . navy . nps . cs . oomi . f iom. * ; 

public  class  ZzzTest_FactoryImpl  extends  TestCase 

{ 


public  ZzzTest_FactoryImpl (String  Name_) 
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{ 

super (Name_) ; 

}  //public  ZzzTest_FactoryImpl (String  Name_) 

protected  void  setup  () 

{ 

}  //protected  void  setup () 

protected  void  tearDownO 

{ 

}  //protected  void  tearDownO 

public  static  void  main (String [ ]  args) 

{ 

String!]  testCaseName  =  ( ZzzTest_FactoryImpl . class . getName ( ) } ; 
junit . swingui . Test Runner . main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

protected  static  void  p (String  m)  ( 

System. out .println (m)  ; 

} 


public  void  test_0()  { 
try  { 

FIOMFactory  _factory  =  Factorylmpl . newFIOMFactory ( ) ; 
assert True (_factory ! =null) ; 

) 

catch  (Exception  exc)  { 
exc .print St ackT race  ( ) ; 

fail (exc . getClass  ( )  +  ":  "  +  exc . getMessage ( ) ) ; 

} 


) 

FIOMFactory  _factory  =  Factorylmpl . newFIOMFactory () ; 

public  void  test_l()  f 

TypeName  type  =  _f actory . makeTypeName (  "Typel"  ); 

Attribute  attr  =  _f actory . makeAttribute (  null,  "Name",  type  ); 

assert True (attr . getName ( ) . equals ( "Name" )  &&  attr . get Type ( ) . toString ( ) . equals ( "Typel" ) ) 

) 


}  //public  class  ZzzTest_FactoryImpl  extends  TestCase 
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17.  ZzzTestFCRImpl.java 


package  mil . navy . nps . cs . oomi . impl ; 


import 

import 

import 

import 


java . util . * ; 

java . io . *; 

java . net . URL; 

junit . framework . TestCase; 


import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


public  class  ZzzTest_FCRImpl  extends  TestCase 

{ 


public  ZzzTest_FCRImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_FCRImpl (String  Name_) 

FIOM  fiom; 

FE  fe_l ; 

String  fev_l_name  =  "FE  1.  FEV  1"; 

FEVImpl  fevlmpl_l; 

FEV  f  ev_l ; 

String  fcr_l_name  =  "FE  1.  FEV  1.  FCR  1"; 

FCRImpl  f crimp 1_1; 

FCR  f  cr_l ; 

protected  void  setup ()  throws  Exception 

{ 

fiom  =  new  FIOMImpl("a  FIOM"); 
fe_l  =  fiom.newFE(  "FE  1"  ); 

fevlmpl_l  =  (FEVImpl) fe_l . createRootFEV (fev_l_name) 
fev_l  =  fevlmpl_l; 

f crlmpl_l  =  new  FCRImpl (fev_l,  "FCR  Impl  1"); 
f cr_l  =  f crimp 1_1 ; 

//fcrlmpl_l  =  (FCRImpl)  fev_l.newF 
}  //protected  void  setup () 
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protected  void  tearDownO 

{ 

}  //protected  void  tearDownO 

public  static  void  main (String [ ]  args) 

{ 

String[]  testCaseName  =  ( ZzzTest_FCRImpl . class . getName () } 
junit . swingui . Test Runner . main (testCaseName)  ; 

}  //public  static  void  main (String [ ]  args) 

public  void  test_constructor_getsetFEV_l ( )  ( 

FCR  fcr  =  new  FCRImpl ( f ev_l ,  "The  Name"); 
assertTrue (  f cr . getFEV ( ) ==f ev_l  ); 

) 

public  void  test_constructor_getsetFCRName_l ( )  ( 

FCR  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 
assertEquals (  "The  Name",  f cr . getFCRName  ( )  ); 

} 

public  void  test_ccrCount_0 ( )  ( 

FCR  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 
assertEquals (  0,  f cr . ccrCount ( )  ); 


public  void  test_constructor_getset_JavaClassName ( )  ( 

FCR  fcr  =  new  FCRImpl (); 
fcr . set JavaClassName ( "a .b . C" )  ; 

assertEquals (  "a.b.C",  fcr . get JavaClassName ( )  ); 

) 


public  void  test_getaddCCR_ccrCount_l ( )  ( 

CCR [ ]  ccrs  =  new  CCR [ ]  {  new  CCRImpl (null,  "System", 

new  CCRImpl (null ,  "System", 
FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 
fcr. addCCR (ccrs [0] )  ; 
fcr. addCCR (ccrs [1] ) ; 

CCR [ ]  ccrSorted  =  f cr . getCCR ( ) ; 

Arrays. sort (  ccrSorted  ); 

assertTrue (  fcr . ccrCount () ==ccrs . length  && 

Arrays . equals (ccrs,  ccrSorted)  && 
ccrs [0 ] . getFCR ( ) ==f cr  && 
ccrs [ 1 ] . getFCR ( ) ==f cr  ); 


"CCR  0") 
"CCR  1") 


/ 
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*  Call  setCCRO  twice,  to  ensure  the  array  replaces  the 

*  add  to  it. 

*/ 

public  void  test_getaddCCR_ccrCount_2 ( )  ( 

CCR [ ]  ccrs  =  new  CCR[]  {  new  CCRImpl (null,  "System", 

new  CCRImpl (null,  "System",  " 
FCRImpl  fcr  =  new  FCRImpl ( f ev_l ,  "The  Name"); 

//  call  setCCRO  twice,  to  ensure 

fcr. addCCR (ccrs [0 ] ) ; 

fcr. addCCR (ccrs [1 ] )  ; 

fcr. addCCR (ccrs [0] ) ; 

fcr. addCCR (ccrs  [1] ) ; 

assertTruel  fcr . ccrCount () ==ccrs . length  && 

Arrays . equals (ccrs,  f cr . getCCR ( ) )  && 
ccrs [0 ] . getFCR ( ) ==f cr  && 
ccrs  [  1 ]  . getFCR ( ) ==f cr  ); 

) 

public  void  test_f indCCR_l ( )  { 

CCR [ ]  ccrs  =  new  CCR[]  {  new  CCRImpl (null,  "System",  " 

new  CCRImpl (null,  "System",  " 
FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 
fcr. addCCR (ccrs [0 ] ) ; 
fcr. addCCR (ccrs [1] )  ; 

assertTruel  fcr . findCCR ( "System" ,  "ccr  0")==ccrs[0]  && 
fcr. findCCR( "System",  "ccr  l")==ccrs[l]  ); 


public  void  test_f indCCR_2_null ( )  ( 

CCR [ ]  ccrs  =  new  CCR[]  {  new  CCRImpl (null,  "System",  " 

new  CCRImpl (null,  "System",  " 
FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 
fcr. addCCR (ccrs [0 ] ) ; 
fcr. addCCR (ccrs [1]  )  ; 

assertTruel  fcr . findCCR ( "System" ,  "ccr  0234")==null  ); 


public  void  test_f indCCR_bySystem_l ( )  ( 

CCR [ ]  ccrs  =  new  CCR[]  {  new  CCRImpl (null, 

new  CCRImpl (null, 
new  CCRImpl (null, 
new  CCRImpl (null. 


"System  A", 
"System",  " 
"System  B", 
"System  a". 


FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 
fcr. addCCR  (ccrs  [0] ) ; 
fcr. addCCR (ccrs  [1] ) ; 


existing  and  not 


"CCR  0") , 
CCR  1")  }; 


CCR  0")  , 
CCR  1")  }; 


CCR  0")  , 
CCR  1")  }; 


"CCR  A  0") , 
CCR  1")  , 

"CCR  1") , 
"CCR  A  1") 
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fcr . addCCR (ccrs [2]  )  ; 
fcr . addCCR (ccrs  [3] ) ; 

CCR [ ]  ccrsFound  =  fcr.findCCR(  "system  a"  ); 
Arrays . sort (ccrsFound) ; 
try  { 

Class  c  =  Class . forName (" java . lang . String" )  ; 
String  s  = (String)  c . newlnstance ( ) ; 


) 

catch  (Exception  e)  {  } 
assertlrue (  ccrsFound . length==2  && 

ccrsFound [0 ]. getCCRName (). equals ( "CCR  A  0")  && 
ccrsFound [ 1 ]. getCCRName (). equals ( "CCR  A  1")  ); 

) 

public  void  test_ccrExists_true ( )  ( 

CCR [ ]  ccrs  =  new  CCR [ ]  {  new  CCRImpl (null,  "System",  "CCR  0"), 

new  CCRImpl (null,  "System",  "CCR  1")  }; 

FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 
fcr. addCCR (ccrs [ 0 ] )  ; 
fcr. addCCR (ccrs [1]  )  ; 

assertTruel  fcr . ccrExists ( "System" ,  "ccR  0")  && 
fcr . ccrExists ( "System" ,  "CCR  1")  ); 


public  void  test_ccrExists_false ( )  ( 

CCR [ ]  ccrs  =  new  CCR[]  {  new  CCRImpl (null,  "System",  "CCR  0"), 

new  CCRImpl (null,  "System",  "CCR  1")  }; 

FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 
fcr. addCCR (ccrs [ 0 ] ) ; 
fcr. addCCR (ccrs [1]  )  ; 

assertTruel  ! fcr . ccrExists ( "System" ,  "A  ccR  0")  ); 


/** 

*  Same  SystemName,  different  CCRName. 

*/ 

public  void  test_newCCR_l_l ( )  throws  Exception  { 

FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 

CCR [ ]  ccrs  =  new  CCR[]  {  fcr . newCCR ( "System" ,  "1",  null), 

fcr . newCCR ( "System" ,  "2",  null)  }; 
assertTruel  fcr . ccrCount () ==ccrs . length  ); 


/** 

*  Same  SystemName,  different  CCRName. 
*/ 
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public  void  test_newCCR_l_2 ( )  throws  Exception  { 

FCRImpl  fcr  =  new  FCRImpl (fev_l,  "The  Name"); 

CCR [ ]  ccrs  =  new  CCR [ ]  {  f cr . newCCR (" System" ,  "1",  null), 

fcr . newCCR ( "System" ,  "2",  null)  }; 

CCR [ ]  ccrSorted  =  f cr . getCCR ( ) ; 

Arrays. sort  (  ccrSorted  ); 

assertTrue (  Arrays . equals (ccrs,  ccrSorted)  ); 


/** 

*  Same  SystemName,  different  CCRName. 

*/ 

public  void  test_newCCR_l_3 ( )  throws  Exception  { 

FCRImpl  fcr  =  new  FCRImpl (fev_l,  "The  Name"); 

CCR [ ]  ccrs  =  new  CCR [ ]  {  f cr . newCCR (" System" ,  "1",  null), 

fcr . newCCR ( "System" ,  "2",  null)  }; 

assertTrue ( 

ccrs [ 0 ] . getFCR ( ) ==fcr  && 
ccrs [ 1 ] . getFCR ( ) ==fcr  ); 


/** 

*  Same  CCRName,  different  SystemName. 

*/ 

public  void  test_newCCR_2 ( )  throws  Exception  { 

FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 

CCR [ ]  ccrs  =  new  CCR [ ]  {  f cr . newCCR (" System" ,  "1",  null), 

fcr . newCCR ( "System" ,  "2",  null)  }; 

CCR [ ]  ccrSorted  =  f  cr .  getCCR  ()  ; 

Arrays. sort (  ccrSorted  ); 

assertTrue (  fcr . ccrCount () ==ccrs . length  && 

Arrays . equals (ccrs,  ccrSorted)  && 
ccrs [0 ]. getFCR () ==fcr  && 
ccrs [1 ]. getFCR () ==fcr  ); 


/** 

*  newCCR ( )  with  duplicate  CCRName  (case-insensitive)  and  SystemName. 

*/ 

public  void  test_newCCR_duplicate_ccr_l ( )  { 

FCRImpl  fcr  =  new  FCRImpl (fev_l,  "The  Name"); 
try  { 

fcr .newCCR ("System",  "1",  null); 
f cr . newCCR (" System" ,  "2  abcdef",  null); 

fcr . newCCR ( "System" ,  "2  AbcDef",  null); 

fail (DuplicateKeyExcept ion . class . getName ( )  +  "  expected  but  not  thrown.") 
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} 

catch  (Exception  exc)  { 

assertEquals (  DuplicateKeyException . class,  exc . getClass ( )  ); 


/** 

*  newCCR ( )  with  duplicate  CCRName  and  SystemName  (case-insensitive). 

*/ 

public  void  test_newCCR_duplicate_ccr_2 ( )  { 

FCRImpl  fcr  =  new  FCRImpl (fev_l,  "The  Name"); 
try  { 

fcr .newCCR ("System",  "1",  null); 

fcr . newCCR ( "System" ,  "2  abcdef",  null); 

fcr . newCCR ( "System" ,  "2  abcDef",  null); 

fail (DuplicateKeyExcept ion . class . getName ( )  +  "  expected  but  not  thrown.") 

} 

catch  (Exception  exc)  { 

assertEquals (  DuplicateKeyException . class,  exc . getClass ( )  ); 

} 

} 

/** 

*  Duplicate  SystemName  and  xmlNameSpaceURI 

*  should  result  in  DuplicateKeyException. 

*/ 

public  void  test_newCCR_duplicate_url_l ( )  { 

FCRImpl  fcr  =  new  FCRImpl (fev_l,  "The  Name"); 
try  { 

String  urlString  =  "http: //q.w.com/abc/dfg/a.xsd"; 
fcr .newCCR ("System",  "1",  null); 

fcr . newCCR ( "System" ,  "2  abcdef",  new  URL (urlString)  )  ; 
fcr . newCCR ( "System" ,  "3  AbcDef",  new  URL (urlString) ) ; 

fail (DuplicateKeyException . class . getName ( )  +  "  expected  but  not  thrown.") 

} 

catch  (Exception  exc)  { 

assertEquals (  DuplicateKeyException . class,  exc . getClass ( )  ); 


public  void  test_getset_FCRSchema_l ( )  throws  Exception  { 
FCRImpl  fcr  =  new  FCRImpl (fev_l,  "The  Name"); 

FCRSchema  newFcrSchema  =  new  FCRSchemalmpl ( ) ; 
fcr . setFCRSchema (newFcrSchema) ; 

assertTrue (  f cr . getFCRSchema ( )  ==  newFcrSchema  ); 

} 
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public  void  test_f indCCR_by_xmlSchemaXML_l ( )  throws  Exception  { 

String  urlString  =  "http: //a.b.com/xsd2 .xsd"; 

FCRImpl  fcr  =  new  FCRImpl (fev_l,  "The  Name"); 

CCR [ ]  ccrs  =  new  CCR [ ]  {  f cr . newCCR (" System" ,  "1",  new  URL ( "http : //a .b . com/xsdl . xsd" ) ) , 

fcr . newCCR ( "System" ,  "2",  new  URL (urlString) ) 

}; 

assertTrue (  ccrs [1]  ==  f cr . f indCCR ( "SysTEM" ,  new  URL (urlString) )  ); 


/** 

*  Tests  case-sensitive  f indCCR (URL) . 

*/ 

public  void  test_f indCCR_by_xmlSchemaXML_2 ( )  throws  Exception  { 

String  urlString  =  "http : //a . b . com/xsd2 . xsd" ; 

FCRImpl  fcr  =  new  FCRImpl (fev_l,  "The  Name"); 

CCR [ ]  ccrs  =  new  CCR [ ]  {  f cr . newCCR (" System" ,  "1",  new  URL ("http: //a .b . com/xsdl .xsd") ) , 

fcr . newCCR ( "System" ,  "2",  new  URL (urlString) ) 

} ; 

assertTrue (  null  ==  f cr . f indCCR ( "SYSTEM" ,  new  URL (urlString . toUpperCase ()) )  ); 


/** 

*  Tests  f indCCR (null) . 

*/ 

public  void  test_f indCCR_by_xmlSchemaXML_3 ( )  throws  Exception  { 

String  urlString  =  "http: //a.b.com/xsd2 .xsd"; 

FCRImpl  fcr  =  new  FCRImpl ( fev_l ,  "The  Name"); 

CCR [ ]  ccrs  =  new  CCR [ ]  {  f cr . newCCR (" System" ,  "1",  new  URL ("http: //a .b . com/xsdl .xsd") ) , 

fcr . newCCR ( "System" ,  "2",  new  URL (urlString) ) 

}; 

assertTrue (  null  ==  f cr . f indCCR ( "System" ,  (URL) null)  ); 


}  //public  class  ZzzTest_FCRImpl  extends  TestCase 

18.  ZzzTestFEImpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  java. util.*; 

import  java.io.*; 

import  j ava . net . URL ; 

import  junit . framework . TestCase; 

import  mil . navy . nps . cs . oomi .* ; 
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import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

public  class  ZzzTest_FEImpl  extends  TestCase 

{ 


public  ZzzTest_FEImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_FEImpl (String  Name_) 

//  Test  variables. 

OOMIDatabase  oomiDb  =  null; 

FIOM  fiom  =  null; 

FEImpl  felmpl  =  null; 

FE  fe  =  null; 

FEV [ ]  fevArray  =  null; 

protected  void  setup ()  throws  Exception 

{ 

OOMIDatabase  oomiDb  =  new  OOMIDatabaselmpl ( ) ; 

FIOM  fiom  =  oomiDb . newFIOM ( "a  fiom"); 
felmpl  =  (FEImpl) fiom. newFE ( "FE  0"); 
fe  =  (FE) felmpl; 

fevArray  =  new  FEVImpl [ ]  {  new  FEVImpl (null,  null,  "FEV  0"), 

new  FEVImpl (null,  null,  "FEV  1")  }; 

}  //protected  void  setup () 

protected  void  tearDown() 

{ 

}  //protected  void  tearDown() 

public  static  void  main (String [ ]  args) 

{ 

String[]  testCaseName  =  { ZzzTest_FEImpl . class . getName ()} ; 
junit . swingui . TestRunner .main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 


public  void  test_constructor_l ( )  { 

String  feName  =  "a  FE"; 

FE  fe  =  new  FEImpl (fiom,  null,  feName); 

assertTrue  (  f e . getFIOM ( ) ==f iom  &&  fe . getFEName (). equals (feName)  ) 
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/** 

*  Tests  getRootFEVO  and  setRootFEV ( ) . 

*  Calls  setRootFEV ()  once. 

*/ 

public  void  test_set_getFEV_2 ( )  { 

FEV  fev  =  new  FEVImplO; 

felmpl . setRootFEV (fev) ; 

assertTrue (  fev  ==  f e . getRootFEV ( )  ); 


/** 

*  Tests  getRootFEVO  and  setRootFEV  ()  . 

*  Calls  setRootFEV ()  twice. 

*/ 

public  void  test_set_getFEV_3 ( )  { 

felmpl . setRootFEV (new  FEVImpl ( ) ) ; 

FEV  fev  =  new  FEVImplO; 
felmpl . setRootFEV (fev) ; 

assertTrue (  fev  ==  felmpl . getRootFEV ()  ); 


/** 

*  Tests  getRootFEVO  and  setRootFEV ()  to  check  if  FE  property  is  properly  set. 

*  Calls  setRootFEV ()  once. 

*/ 

public  void  test_set_getFEV_4 ()  { 

FEV  fev  =  new  FEVImplO; 
felmpl . setRootFEV (fev) ; 
assertTrue  (  fev.getFEO  ==  fe  ); 


public  void  test_equals_true ()  { 

FIOM  fioml  =  new  FIOMImpl ( "my  name"); 
FIOM  fiom2  =  new  FIOMImpl ("my  nAme") ; 
assertEquals (  fioml,  fiom2  ) ; 

} 

public  void  test_equals_f alse ()  { 

FIOM  fioml  =  new  FIOMImpl ("my  namel") ; 
FIOM  fiom2  =  new  FIOMImpl ("my  name"); 
assertTrue (  !  fioml . equals (fiom2)  ); 

} 

public  void  test_equals_null ()  { 


FIOM  fioml  =  new  FIOMImpl ("my  namel"); 
assertTrue (  !  fioml . equals (null )  ); 
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} 

public  void  test_f indFEV_l ( )  throws  Exception  { 

FEV  rootFEV  =  f elmpl . createRootFEV ( "ROOT" ) ; 
rootFEV. newChild ( "child  fev  1" )  ; 

FEV  target  =  rootFEV. newChild ( "child  fev  2 "). newChild ( "2 . 1 " ) 
assertTrue (  f e . f indFEV ( "2 . 1 " )  ==  target  ); 


/** 

*  Test  finding  the  root  FEV. 

*/ 

public  void  test_f indFEV_2 ( )  throws  Exception  { 

FEV  rootFEV  =  f elmpl . createRootFEV ( "ROOT" ) ; 
rootFEV. newChild ( "child  fev  1"); 

FEV  target  =  rootFEV. newChild ( "child  fev  2 "). newChild ( "2 . 1 " ) 
assertTrue (  f e . f indFEV ( "ROOT" )  ==  rootFEV  ); 

} 

public  void  test_f evExists_l ( )  throws  Exception  { 

FEV  rootFEV  =  f elmpl . createRootFEV ( "ROOT" ) ; 
rootFEV. newChild ( "child  fev  1"); 

FEV  target  =  rootFEV. newChild ( "child  fev  2 "). newChild ( "2 . 1 " ) 
assertTrue  (  f e . f evExists  ( "2 . 1 " )  ); 

} 

public  void  test_createFEV_l  ()  throws  Exception  { 

FEV  rootFEV  =  fe . createRootFEV ( "ROOT" ) ; 
assertTrue (  f e . getRootFEV ( )  ==  rootFEV  ); 

} 

public  void  test_createFEV_2  ()  throws  Exception  { 

FEV  rootFEV  =  fe . createRootFEV ( "ROOT" ) ; 
assertTrue (  f e . getRootFEV (). getFE ( )  ==  fe  ); 


/** 

*  Test  get/set  Parent. 

*/ 

public  void  test_getParent_setParent_l ( )  throws  Exception  { 
FE  parent  =  new  FEImpl (  ) ; 

FEImpl  fe  =  new  FEImpl (  null,  parent,  "abc"  ) ; 
assertTrue (  f e . getParent ( )  ==  parent  ); 


/** 

*  Test  newChild ()  and  getChild(). 
*/ 
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public  void  test_newChild_getChild_l ( )  throws  Exception  { 
FE  fe  =  new  FEImplO; 

FE  child  =  fe . newChild ( "child  1"); 
assertTrue (  child. getParent () ==fe  ); 


/** 

*  Test  newChild ()  and  getChild(). 

*/ 

public  void  test_newChild_getChild_2 ( )  throws  Exception  { 
FE  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 

assertTrue (  Arrays . equals (  children,  f e . getChild ( )  )  ); 


/** 

*  Test  newChild ()  and  getChild (). 

*/ 

public  void  test_newChild_getChild_3 ( )  throws  Exception  { 
FE  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 

assertTrue (  children [ 0 ]. getFEName (). equals ( "child  1")  && 
children [1] . getFEName () .equals ("child  2")  ); 


/** 

*  Test  setChildO  Parent  property  set. 

*/ 

public  void  test_setChild_Parent ()  throws  Exception  { 

FEImpl  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  new  FEImpl (null,  null,  "child  1"), 

new  FEImpl (null,  null,  "child  2")  }; 

fe . setChild (children) ; 

FE  [  ]  ch  =  fe . getChild ()  ; 
assertTrue (  ch [ 0 ]. getParent () ==fe  && 
ch [ 1 ]. getParent () ==fe  ); 


/** 

*  Test  setChild ()  FIOM  property  set. 

*/ 

public  void  test_setChild_FIOM ( )  throws  Exception  { 

FEImpl  fe  =  new  FEImplO; 
f  e  .  setFIOM  (new  FIOMImpl  ()  )  ; 

FE [ ]  children  =  new  FE [ ]  {  new  FEImpl (null,  null,  "child  1"), 
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new  FEImpl (null,  null 


child  2")  }; 


fe . setChild (children)  ; 

FE [ ]  ch  =  fe . getChild ( ) ; 

assertTrue (  ch [ 0 ] . getFIOM ( ) ==fe . getFIOM ( ) 
ch [ 1 ] . getFIOM ( ) ==f e . getFIOM ( ) 


&& 
)  ; 


/** 

*  Test  childCountO  and  that  it  counts  only  the  first  level. 
*/ 

public  void  test_childCount_l ( )  throws  Exception  { 

FE  fe  =  new  FEImpl (); 
fe . newChild ( "child  1"); 
assertEquals (  1,  f e . childCount ( )  ); 


/** 

*  Test  childCountO  and  that  it  counts  only  the  first  level. 
*/ 

public  void  test_childCount_2 ( )  throws  Exception  { 

FE  fe  =  new  FEImpl (); 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 
children [0] . newChild ( "random  child") ; 
assertEquals (  children . length,  fe . childCount ( )  ); 


/** 

*  Recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_A ( )  throws  Exception  { 

FE  fe  =  new  FEImpl (); 

FE  target  =  fe . newChild ( "child  1"); 

assertTrue (  fe . f indDescendent ( "CHild  1",  true)  ==  target  ); 


/** 

*  Recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_B ( )  throws  Exception  { 

FE  fe  =  new  FEImpl (); 

FE  target  =  fe . newChild ( "child  1"); 
fe . newChild ( "child  2"); 

assertTrue (  fe . f indDescendent ( "CHild  1",  true)  ==  target  ); 
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*  Recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_C ( )  throws  Exception  { 

FE  fe  =  new  FEImplO; 
fe . newChild ( "child  1"); 

FE  target  =  fe . newChild ( "child  2"); 

assertTrue (  fe . f indDescendent ( "CHild  2",  true)  ==  target  ); 


/** 

*  Non-Recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_D ( )  throws  Exception  { 

FE  fe  =  new  FEImplO; 
fe . newChild ( "child  1"); 

FE  target  =  fe . newChild ( "child  2"); 

assertTrue (  fe . f indDescendent ( "CHild  2",  false)  ==  target  ) 


/** 

*  Recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_l ( )  throws  Exception  { 

FE  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 

FE  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
children [0]  . newChild ( "child  12")  ; 

assertTrue (  fe . f indDescendent ( "CHild  11",  true)  ==  target  ) 


/** 

*  Non-recursive  f indDescendent () 

*/ 

public  void  test_findDescendent_2 ()  throws  Exception  { 

FE  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 
FE  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 


children [ 0 ]  . newChild ( "child  12 "  )  ; 


assertTrue (  !  (fe . f indDescendent ( "child  111",  false)  ==  target)  ) 


/** 

*  Recursive  f indDescendent () ,  child  found  at  first  level. 

*/ 

public  void  test_f indDescendent_3 ( )  throws  Exception  { 

FE  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 

FE  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
children [ 0 ]  . newChild ( "child  12" )  ; 

assertTrue (  fe . f indDescendent ( "CHild  2",  true)  ==  children [1]  ); 


/** 

*  Recursive  hasDescendent ( ) 

*/ 

public  void  test_hasDescendent_l ( )  throws  Exception  { 
FEImpl  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 
FE  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
children [ 0 ]  . newChild ( "child  12" )  ; 

assertTrue (  fe . hasDescendent ( "CHild  111",  true)  ); 


/** 

*  Non-recursive  hasDescendent ( ) 

*/ 

public  void  test_hasDescendent_2 ( )  throws  Exception  { 
FEImpl  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 
FE  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
children [ 0 ]  . newChild ( "child  12" )  ; 

assertTrue (  !  fe . hasDescendent ( "child  111",  false)  ); 

} 
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/ 


*  Test  newChild  with  duplicate  name. 

*/ 

public  void  test_newChild_duplicate_l ( )  { 

try  { 

FE  fe  =  new  FEImplO; 

FE [ ]  children  =  new  FE [ ]  {  fe . newChild ( "child  1"), 

fe . newChild ( "child  2")  }; 

FE  target  =  children [ 0 ]. newChild ( "child  11"); 

FE  c  =  target . newChild ( "child  111"); 
f e . newChild (c . getFEName ( ) )  ; 

fail (DuplicateKeyException . class . getName ( )  +  "  expected,  but  not  thrown"  ); 

} 

catch  (Exception  exc)  { 

assertEquals (  DuplicateKeyException . class,  exc . getClass ( )  ); 


/** 

*  findCCRO,  target  in  this  FE '  s  child's  list  of  CCRs . 

*/ 

public  void  test_f indCCR_l ( )  throws  Exception  { 

String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FE  rootFE  =  new  FEImplO; 

FE  fe; 

FCR  for; 

//  level  1 

String  suffix  =  "0"; 

fe  =  rootFE . newChild (  "Child"  +  suffix  ); 

fcr  =  f e . createRootFEV (  "FEV"  +  suffix  ).createFCR(  "FCR"  +  suffix  ); 
CCR  target  =  fcr.newCCR(  systemName,  ccrName,  new  URL (urlString)  ); 

assertTrue ( 

rootFE . findCCR (systemName,  new  URL (urlString) )  ==  target  ); 


/** 

*  findCCRO,  target  in  this  FE '  s  own  list  of  CCRs. 
*/ 

public  void  test_findCCR_2 ()  throws  Exception  { 
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String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FE  rootFE  =  new  FEImplO; 

FCR  rootFCR  =  rootFE . createRootFEV ( "ROOT" ). createFCR ( "ROOT  FCR" ) ; 
rootFCR. newCCR ( "s" ,  "cc",  new  URL ( "http : //a . com/asdf . xsd" ))  ; 

FE  fe; 

FCR  fcr; 

//  level  1 

String  suffix  =  "0"; 

fe  =  rootFE . newChild (  "Child"  +  suffix  ); 

fcr  =  fe . createRootFEV (  "FEV"  +  suffix  ). createFCR (  "FCR"  +  suffix  ); 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/0 . xsd"  +  suffix)  ); 

CCR  target  =  rootFCR. newCCR (systemName,  ccrName,  new  URL (urlString) )  ; 

assertTrue ( 

rootFE . findCCR (systemName,  new  URL (urlString) )  ==  target  && 
rootFE . findDescendentCCR (systemName,  new  URL (urlString) )  ==  null  ); 


/** 

*  findCCR (String  systemName). 

*/ 

public  void  test_f indCCR_3 ( )  throws  Exception  { 

String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FE  rootFE  =  new  FEImplO; 

FCR  rootFCR  =  rootFE . createRootFEV ( "ROOT" ). createFCR ( "ROOT  FCR"); 
rootFCR. newCCR ( "s" ,  "cc",  new  URL ( "http : //a . com/asdf . xsd" )) ; 

FE  fe; 

FCR  fcr; 

//  level  1 

String  suffix  =  "0"; 

fe  =  rootFE . newChild (  "Child"  +  suffix  ); 

fcr  =  fe . createRootFEV (  "FEV"  +  suffix  ). createFCR (  "FCR"  +  suffix  ); 
CCR  ccrl  =  fcr. newCCR (  "System"  +  suffix,  "CCR  1"  +  suffix, 

new  URL ( "http : //a . com/0 . xsd"  +  suffix)  ); 
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fcr.newCCR(  "SystemA"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/O . xsd"  +  suffix)  ); 

CCR  ccr2  =  fcr.newCCR(  "System"  +  suffix,  "CCR  2"  +  suffix, 

new  URL ( "http : //a .b . com/O . xsd"  +  suffix)  ); 

CCR  target  =  rootFCR. newCCR (systemName,  ccrName,  new  URL (urlString) ) ; 
CCR[]  result  =  f e . f indCCR (ccrl . getSystemName ( ) ) ; 

Arrays. sort (  result  ); 

assertTrue (  result [ 0 ]. getCCRName (). equals (ccrl . getCCRName () )  && 
result [ 1 ] . getCCRName ( ) . equals (ccr2 . getCCRName ( ) ) 

)  ; 


/** 

*  f indDescendentCCR ( ) ,  target  in  first-level. 

*/ 

public  void  test_f indDescendentCCR_l ( )  throws  Exception  { 

String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FE  rootFE  =  new  FEImplO; 

FE  fe; 

FCR  fcr; 

//  level  1 

String  suffix  =  "0"; 

fe  =  rootFE . newChild (  "Child"  +  suffix  ); 

fcr  =  f e . createRootFEV (  "FEV"  +  suffix  ).createFCR(  "FCR"  +  suffix  ) 
CCR  target  =  f cr. newCCR (  systemName,  ccrName,  new  URL (urlString)  ); 

assertTrue ( 

rootFE . f indDescendentCCR (systemName,  new  URL (urlString) )  ==  target  ) 

} 


/** 

*  Recursive  f indDescendentCCR () ,  target  in  grandchild 
*/ 

public  void  test_f indDescendentCCR_2 ( )  throws  Exception  { 
String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FE  rootFE  =  new  FEImplO; 
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FE  fe; 


FCR  fcr; 

//  level  1 

String  suffix  =  "0"; 

fe  =  rootFE . newChild (  "Child"  +  suffix  ); 

fcr  =  f e . createRootFEV (  "FEV"  +  suffix  ).createFCR(  "FCR"  +  suffix  ) 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/0 . xsd"  +  suffix)  ); 

//  level  2 
suffix  =  "0.1"; 

fe  =  fe.newChild(  "Child"  +  suffix  ); 

fcr  =  fe . createRootFEV (  "FEV"  +  suffix  ).createFCR(  "FCR"  +  suffix  ) 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/0 . xsd"  +  suffix)  ); 

//  level  1 
suffix  =  "1"; 

fe  =  rootFE . newChild (  "Child"  +  suffix  ); 

fcr  =  fe . createRootFEV (  "FEV"  +  suffix  ).createFCR(  "FCR"  +  suffix  ) 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/0 . xsd"  +  suffix)  ); 

//  level  2 
suffix  =  "1.1"; 

fe  =  fe.newChild(  "Child"  +  suffix  ); 

fcr  =  fe . createRootFEV (  "FEV"  +  suffix  ).createFCR(  "FCR"  +  suffix  ) 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/0 . xsd"  +  suffix)  ); 

CCR  target  =  fcr.newCCR(  systemName,  ccrName,  new  URL (urlString)  ); 


assertTrue ( 


} 


rootFE . f indDescendentCCR (systemName, 
==  target  ) ; 


new  URL (urlString) ) 


}  //public  class  ZzzTest_FEImpl  extends  TestCase 

19.  ZzzTestFEVImpl.java 

package  mil . navy . nps . cs . oomi . impl ; 


import  java. util.*; 
import  java.io.*; 
import  j ava . net . URL ; 
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import  junit . framework . TestCase; 


import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

public  class  ZzzTest_FEVImpl  extends  TestCase 

{ 


public  ZzzTest_FEVImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_FEVImpl (String  Name_) 


FIOM  fiom; 

FE  f e_l ; 

protected  void  setup ()  throws  Exception 

{ 

fiom  =  new  FIOMImpl("a  FIOM"); 
fe_l  =  fiom.newFE(  "FE  1"  ); 

}  //protected  void  setup ()s 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_FEVImpl . class . getName () } 
junit . swingui . TestRunner .main (testCaseName)  ; 

}  //public  static  void  main (String [ ]  args) 


/** 

*  Test  FEVImpl (FE,  String),  get/set  Parent,  FE  and  FEVName. 
*/ 

public  void  test_constructor_l ( )  { 

FEV  parent  =  new  FEVImpl (  null,  fe_l,  "root  FEV"); 

FEV  fev  =  new  FEVImpl (  parent,  fe_l,  "this  FEV"  ); 

assertTrue  (  fev . getFEVName (). equals ( "this  FEV")  && 
fev.getFEO  ==  fe_l  && 
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f ev . getParent ( )  ==  parent  ); 


public  void  test_equals_true ( )  { 

FEV  fevl  =  new  FEVImpl (null,  fe_l,  "my  namE") ; 

FEV  fev2  =  new  FEVImpl (null,  fe_l,  "my  name"); 

assertTrue (  fevl . equals (fev2)  &&  fevl . hashCode ( ) ==fev2 . hashCode ( )  ) 

} 

public  void  test_equals_f alse_name_not_equal ( )  { 

FEV  fevl  =  new  FEVImpl (null,  fe_l,  "my  name"); 

FEV  fev2  =  new  FEVImpl (null,  fe_l,  "my  name"); 

assertTrue  (  !  fevl . equals (fev2)  ); 

} 

public  void  test_equals_f alse_f e_not_equal ( )  { 

FEV  fevl  =  new  FEVImpl (null,  fe_l,  "my  name"); 

FEV  fev2  =  new  FEVImpl (null,  new  FEImpl(),  "my  name"); 
assertTrue (  !  fevl . equals (fev2)  ); 

} 

public  void  test_equals_null ( )  { 

FEV  fevl  =  new  FEVImpl (null,  fe_l,  "my  name"); 
assertTrue (  !  fevl . equals (null )  ); 


public  void  test_setgetFCR_l ( )  { 

FEVImpl  fevlmpll  =  new  FEVImpl (null,  fe_l,  "my  name"); 
FCR  for  =  new  FCRImpl(); 
fevlmpll . setFCR (fcr)  ; 

assertTrue (  fevlmpll . getFCR () ==fcr  ); 

} 

public  void  test_setgetFCR_2 ( )  { 

FEVImpl  fevlmpll  =  new  FEVImpl (null,  fe_l,  "my  name"); 
FCR  fcr  =  new  FCRImpl(); 
fevlmpll . setFCR (fcr)  ; 

assertTrue (  fevlmpll . getFCR (). getFEV () ==fevlmpll  ); 

} 

public  void  test_create_l ( )  { 

FEV  fev  =  new  FEVImpl (); 

FCR  fcr  =  f ev . createFCR ( "FCR  name  1"); 
assertTrue  (  f ev . getFCR () ==fcr  ); 


/** 

*  Calls  createFCR ()  twice,  to  ensure  first  FCR  value  is  replaced. 
*/ 

public  void  test_create_2 ( )  { 
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FEV  fev  =  new  FEVImplO; 


FCR  fcrl  =  f ev . createFCR ( "FCR  name  1") ; 
FCR  fcr2  =  fev . createFCR ( "FCR  name  2"); 
assertTrue (  f ev . getFCR ( ) ==f cr2  ); 


/** 

*  Test  get/set  Parent. 

*/ 

public  void  test_getParent_setParent_l  ( )  throws  Exception  { 
FEV  parent  =  new  FEVImpl (  ) ; 

FEVImpl  fev  =  new  FEVImpl (  parent,  null,  "abc"  ) ; 
assertTrue (  f ev . getParent ( )  ==  parent  ); 


/** 

*  Test  newChildO  and  getChild(). 

*/ 

public  void  test_newChild_getChild_l ( )  throws  Exception  { 
FEV  fev  =  new  FEVImplO; 

FEV  child  =  fev . newChild ( "child  1"); 
assertTrue (  child. getParent () ==fev  ); 


/** 

*  Test  newChild ()  and  getChild(). 

*/ 

public  void  test_newChild_getChild_2 ( )  throws  Exception  { 
FEV  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

assertTrue (  Arrays . equals (  children,  f ev . getChild ()  )  ); 


/** 

*  Test  newChild ()  and  getChild (). 

*/ 

public  void  test_newChild_getChild_3 ()  throws  Exception  { 
FEV  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

assertTrue (  children [0] . getFEVName (). equals ( "child  1")  && 
children [1] . getFEVName () .equals ("child  2")  ); 


/** 

*  Test  setChildO  Parent  property  set. 
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*/ 

public  void  test_setChild_Parent ( )  throws  Exception  { 

FEVImpl  fev  =  new  FEVImpl(); 

FEV [ ]  children  =  new  FEV [ ]  {  new  FEVImpl (null,  null,  "child  1"), 

new  FEVImpl (null,  null,  "child  2")  } 

fev . setChild (children)  ; 

FEV [ ]  ch  =  f ev . getChild ( ) ; 
assertTrue  (  ch [ 0 ]  . getParent ( ) ==f ev  && 
ch [ 1 ] . getParent ( ) ==fev  ); 


I  k  k 


*  Test  setChild ()  FE  property  set. 


*/ 


public  void  test_setChild_FE ( )  throws  Exception  { 
FEVImpl  fev  =  new  FEVImpl (); 
f  ev .  setFE  (new  FEImplO); 

FEV [ ]  children  =  new  FEV [ ]  {  new  FEVImpl (null,  null, 

new  FEVImpl (null,  null. 


fev . setChild (children) ; 

FEV [ ]  ch  =  f ev . getChild () ; 
assertTrue (  ch [ 0 ] . getFE ( ) ==fev . getFE ( ) 
ch [ 1 ] . getFE ( ) ==f ev . getFE ( ) 


&& 
)  ; 


"child  1") , 
"child  2")  } 


/** 

*  Test  childCountO  and  that  it  counts  only  the  first  level. 
*/ 

public  void  test_childCount_l ( )  throws  Exception  { 

FEV  fev  =  new  FEVImpl (); 
fev . newChild ( "child  1"); 
assertEquals (  1,  f ev . childCount ( )  ); 


/** 

*  Test  childCountO  and  that  it  counts  only  the  first  level. 
*/ 

public  void  test_childCount_2 ( )  throws  Exception  { 

FEV  fev  =  new  FEVImpl (); 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

children [0] . newChild ( "random  child"); 
assertEquals (  children . length,  fev . childCount ( )  ); 


j  k  k 
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*  Recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_A ( )  throws  Exception  { 

FEV  fev  =  new  FEVImplO; 

FEV  target  =  fev . newChild ( "child  1"); 

assertTrue (  fev . f indDescendent ( "CHild  1",  true)  ==  target  ); 


/** 

*  Recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_B ( )  throws  Exception  { 

FEV  fev  =  new  FEVImplO; 

FEV  target  =  fev . newChild ( "child  1"); 
fev . newChild ( "child  2"); 

assertTrue (  fev . f indDescendent ( "CHild  1",  true)  ==  target  ); 


/** 

*  Recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_C ( )  throws  Exception  { 

FEV  fev  =  new  FEVImplO; 
fev . newChild ( "child  1"); 

FEV  target  =  fev . newChild ( "child  2"); 

assertTrue (  fev . f indDescendent ( "CHild  2",  true)  ==  target  ); 


/** 

*  Non-Recursive  f indDescendent () 

*/ 

public  void  test_f indDescendent_D ()  throws  Exception  { 

FEV  fev  =  new  FEVImplO; 
fev . newChild ( "child  1"); 

FEV  target  =  fev . newChild ( "child  2"); 

assertTrue  (  fev . f indDescendent ( "CHild  2",  false)  ==  target  ) 


/** 

*  Recursive  f indDescendent () 

*/ 

public  void  test_findDescendent_l ()  throws  Exception  { 
FEV  fev  =  new  FEVImplO; 
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FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

FEV  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
children [0]  . newChild ( "child  12")  ; 

assertTrue (  f ev . f indDescendent ( "CHild  11",  true)  ==  target  ); 


/** 

*  Non-recursive  f indDescendent ( ) 

*/ 

public  void  test_f indDescendent_2 ( )  throws  Exception  { 

FEV  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

FEV  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
children [0]  . newChild ( "child  12")  ; 

assertTrue (  !  (fev. f indDescendent ( "child  111",  false)  ==  target)  ) 


/** 

*  Recursive  f indDescendent () ,  child  found  at  first  level. 

*/ 

public  void  test_f indDescendent_3 ( )  throws  Exception  { 

FEV  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

FEV  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
children [0]  . newChild ( "child  12")  ; 

assertTrue (  fev . f indDescendent ( "CHild  2",  true)  ==  children [1]  ); 


/** 

*  Recursive  hasDescendent ( ) 

*/ 

public  void  test_hasDescendent_l ( )  throws  Exception  { 
FEVImpl  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

FEV  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
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children [ 0 ]  . newChild ( "child  12 "  )  ; 


assertTrue (  f ev . hasDescendent ( "CHild  111",  true)  ); 


/** 

*  Non-recursive  hasDescendent ( ) 

*/ 

public  void  test_hasDescendent_2 ( )  throws  Exception  { 
FEVImpl  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

FEV  target  =  children [ 0 ]. newChild ( "child  11"); 
target . newChild ( "child  111"); 
children [ 0 ]  . newChild ( "child  12" )  ; 

assertTrue (  !  fev . hasDescendent ( "child  111",  false)  ); 

} 


/** 

*  Test  newChild  with  duplicate  name. 

*/ 

public  void  test_newChild_duplicate_l ( )  { 

try  { 

FEV  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

FEV  target  =  children [ 0 ]. newChild ( "child  11"); 

FEV  c  =  target . newChild ( "child  111"); 
fev . newChild (c . getFEVName ( ) )  ; 

fail (DuplicateKeyExcept ion . class . getName ( )  +  "  expected,  but  not  thrown" 

} 

catch  (Exception  exc)  { 

assertEquals (  DuplicateKeyException . class,  exc . getClass ( )  ); 


/** 

*  Recursive  f indDescendentCCR ( ) 

*/ 

public  void  test_f indDescendentCCR_l ( )  throws  Exception  { 
String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 
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FEV  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1") 


FCR  [  ] 

CCR  [  ] 


fev . newChild ( "child  2")  }; 

fcrArray  =  new  FCR[]  {  children [ 0 ]. createFCR ( "FCR  0"), 

children [ 1 ]. createFCR ( "FCR  0")  }; 

ccrArray 

new  CCR[]  {  f crArray [ 0 ] . newCCR (  "SystemO",  "SysO  CCRO", 

new  URL ( "http : //a . com/a . xsd" )  ), 

fcrArray [1] .newCCR (  "Systeml",  "Sysl  CCR1", 


new  URL ( "http : //b . com/b . xsd" )  ) 


CCR  target  =  f crArray [ 1 ]. newCCR (  systemName,  ccrName,  new  URL (urlString)  ); 

assertTrue (  fev. findDescendentCCR (systemName,  new  URL (urlString) )  ==  target  ); 

} 

/** 

*  Helper  method  to  create  a  FEV  tree  for  testing,  all  names  will 

*  begin  with  the  specified  string  prefix. 

*  Returns  the  CCR  that  is  to  be  found. 

*/ 

public  static  CCR  createFEVTreeCCR ( 

FEV  fev. 

String  prefix. 

String  systemName, 

String  ccrName, 

String  urlString 
)  throws  Exception  { 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 

FEV [ ]  grandchildren  =  new  FEV [ ]  {  children [ 0 ]. newChild ( "child  0-0"), 

children [ 0 ] . newChild ( "child  0-1 " ) , 
children [ 1 ] . newChild ( "child  1-0 " ) , 
children [ 1 ]  . newChild ( "child  1-1" )  , 
children [1] . newChild ( "child  1-2") 

} ; 

FCR[]  fcrArray  =  new  FCR [ ]  {  children [ 0 ]. createFCR ( "FCR  0"), 

children [ 1 ]  . createFCR ( "FCR  0 " )  , 
grandchildren [ 0 ] . createFCR ( "FCR  0"), 
grandchildren [ 1 ] . createFCR ( "FCR  0"), 
grandchildren [2 ] . createFCR ( "FCR  0"), 
grandchildren [ 3 ] . createFCR ( "FCR  0"), 
grandchildren [ 4 ] . createFCR ( "FCR  0") 

}; 
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CCR[]  ccrArray  =  new  CCR [ f crArray . length] ; 
for  (int  i=0;  i<ccrArray . length;  i++)  { 

String  indexStr  =  String . valueOf (i) ; 

ccrArray[i]  =  f crArray [ i ] . newCCR (  "System"  +  indexStr, 

"Sys  CCR  "  +  indexStr, 

new  URL ( "http : //a . com/ "  +  indexStr  +  ".xsd")); 

} 

CCR  target  =  f crArray [ 3 ]. newCCR (  systemName,  ccrName,  new  URL (urlString)  ); 
return  target; 


/** 

*  Recursive  f indDescendentCCR ( ) ,  target  in  grandchild 
*/ 

public  void  test_f indDescendentCCR_2 ( )  throws  Exception  { 

String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FEV  fev  =  new  FEVImplO; 

CCR  target  =  createFEVTreeCCR (fev,  "abc",  systemName,  ccrName,  urlString  ); 
assertTrue (  fev. f indDescendentCCR (systemName,  new  URL (urlString) )  ==  target  ) 


/** 

*  Recursive  f indDescendentCCR () ,  target  in  grandchild 
*/ 

public  void  test_f indDescendentCCR_3 ( )  throws  Exception  { 

String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FEV  fev  =  new  FEVImplO; 

FCR  for  =  fev . createFCR ( "FCR" ) ; 

CCR  target  =  for . newCCR (systemName,  ccrName,  new  URL (urlString) ) ; 
assertTrue (  fev. f indDescendentCCR (systemName,  new  URL (urlString) )  ==  null  ); 


/** 

*  Recursive  f indDescendentCCR () ,  no  match,  null  expected. 
*/ 

public  void  test_f indDescendentCCR_4 ( )  throws  Exception  { 
String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FEV  fev  =  new  FEVImplO; 

FEV [ ]  children  =  new  FEV [ ]  {  fev . newChild ( "child  1"), 

fev . newChild ( "child  2")  }; 
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FEV [ ]  grandchildren  =  new  FEV [ ]  {  children [ 0 ]. newChild ( "child  0-0"), 

children [ 0 ] . newChild ( "child  0-1 " ) , 
children [ 1 ] . newChild ( "child  1-0 " ) , 
children [ 1 ] . newChild ( "child  1-1" ) , 
children [1] . newChild ( "child  1-2") 

} ; 

FCR[]  fcrArray  =  new  FCR [ ]  {  children [ 0 ]. createFCR ( "FCR  0"), 

children [ 1 ]  . createFCR ( "FCR  0 " )  , 
grandchildren [ 0 ] . createFCR ( "FCR  0"), 
grandchildren [ 1 ] . createFCR ( "FCR  0"), 
grandchildren [2 ] . createFCR ( "FCR  0"), 
grandchildren [ 3 ] . createFCR ( "FCR  0"), 
grandchildren [ 4 ] . createFCR ( "FCR  0"), 

} ; 

CCR[]  ccrArray  =  new  CCR [ fcrArray . length]  ; 

for  (int  i=0;  icccrArray . length;  i++)  { 

String  indexStr  =  String . valueOf (i) ; 

ccrArray[i]  =  f crArray [ i ] . newCCR (  "System"  +  indexStr, 

"Sys  CCR  "  +  indexStr, 

new  URL ( "http : //a . com/ "  +  indexStr  +  ".xsd") 

} 

CCR  target  =  f crArray [ 3 ]. newCCR (  systemName,  ccrName,  new  URL (urlString) 

assertTrue (  fev. findDescendentCCR (systemName  +  "a",  new  URL (urlString) )  =: 

} 


/** 

*  Recursive  findCCRO,  target  in  its  own  CCRs . 

*/ 

public  void  test_f indCCR_l ( )  throws  Exception  { 

String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 

FEV  fev  =  new  FEVImplO; 

FCR  for  =  fev. createFCR ( "FCR" ) ; 

CCR  target  =  fcr . newCCR (systemName,  ccrName,  new  URL (urlString) ) ; 
assertTrue (  fev. findCCR (systemName,  new  URL (urlString) )  ==  target  ); 


/** 

*  Recursive  findCCR (),  target  in  its  grandchildren's  CCRs. 
*/ 

public  void  test_f indCCR_2 ( )  throws  Exception  { 

String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 


)  ; 

)  ; 

null  ) 
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String  urlString  =  "http://findme.com/found.xsd"; 

FEV  rootFEV  =  new  FEVImpl ( ) ; 

FCR  fcr  =  rootFEV. createFCR ( "FCR" ) ; 

//  level  1 

String  suffix  =  "1"; 

FEV  fev  =  rootFEV. newChild ( "FEV"  +  suffix); 
fcr  =  fev . createFCR (  "FCR"  +  suffix  ); 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/O . xsd"  +  suffix)  ); 

//  level  2 
suffix  =  "2"; 

fev  =  fev . newChild ( "FEV"  +  suffix); 

fcr  =  fev . createFCR (  "FCR"  +  suffix  ); 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/O . xsd"  +  suffix)  ); 

CCR  target  =  f cr . newCCR (systemName,  ccrName,  new  URL (urlString) ) ; 
assertTrue  (  rootFEV. findCCR (systemName,  new  URL (urlString) )  ==  target  ) 


}  //public  class  ZzzTest_FEVImpl  extends  TestCase 

20.  ZzzTestFIOMImpl.java 

package  mil . navy . nps . cs . oomi . impl ; 
import  java. util.*; 
import  java . net . URL; 

import  junit . framework . TestCase; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

public  class  ZzzTest_FIOMImpl  extends  TestCase 

{ 


public  ZzzTest_FIOMImpl (String  Name_) 

{ 

super  (Name_)  ; 

}  //public  ZzzTest_FIOMImpl (String  Name_) 


FE [ ]  feArray; 
FIOMImpl  fiomlmpl; 
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FIOM  fiom; 

protected  void  setup () 

{ 


feArray  =  new  FE [ ] 

{  new  FEImpl(null, 

null. 

"FE  0 

new  FEImpl(null, 

null. 

"FE  1 

fiomlmpl  =  new  FIOMImpl("A  FIOM"); 
f iomlmpl . setFE (feArray) ; 
fiom  =  fiomlmpl; 

}  //protected  void  setup () 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_FIOMImpl . class . getName () } 
junit . swingui . TestRunner .main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

public  void  test_l()  { 

String  name  =  "my  name"; 

FIOM  fiom  =  new  FIOMImpl ( "my  name"); 
assertEquals (  name,  f iom. getFIOMName ( )  ); 


public  void  test_equals_true ( )  { 

FIOM  fioml  =  new  FIOMImpl ("my  name"); 

FIOM  fiom2  =  new  FIOMImpl ("my  name"); 
assertEquals (  fioml,  fiom2  )  ; 

} 

public  void  test_equals_f alse_l ( )  { 

FIOM  fioml  =  new  FIOMImpl ("my  namel"); 

FIOM  fiom2  =  new  FIOMImpl ("my  name"); 
assertTrue (  !  fioml . equals (fiom2)  ); 

} 

public  void  test_equals_f alse_2 ( )  throws  Exception  { 
FIOM  fioml  =  new  FIOMImpl ("my  name"); 
fioml . newFE (  "fel"  ); 

FIOM  fiom2  =  new  FIOMImpl (fioml . getFIOMName ()) ; 
f iom2. newFE  (  "fe2"  ); 

assertTrue (  !  fioml . equals (fiom2)  ); 
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public  void  test_equals_null ( )  { 

FIOM  fioml  =  new  FIOMImpl("my  namel") ; 
assertTrue  (  !  fioml . equals  (null )  ); 

} 

public  void  test_f eCount_l ( )  { 

FIOM  fiom  =  new  FIOMImpl("A  FIOM"); 
assertEquals (  0,  f iom. f eCount ( )  ); 

} 

public  void  test_getFE_setFE_l ( )  { 

FE [ ]  feArray  =  new  FE [ ]  {  new  FEImpl(null, 

new  FEImpl(null, 

FIOMImpl  fiom  =  new  FIOMImpl("A  FIOM"); 
fiom. setFE (feArray)  ; 

FE  [  ]  testee  =  f iom. getFE ( ) ; 

assertTrue (  Arrays . equals (  feArray,  testee 
testee [ 0 ]. getFIOM () ==f iom  && 
testee [1 ]. getFIOM () ==f iom  ); 


/** 

*  Tests  calling  setFE  ()  twice. 

*/ 

public  void  test_getFE_setFE_2 ( )  { 

FE [ ]  feArray  =  new  FE [ ]  {  new  FEImpl(null, 

new  FEImpl(null, 

FIOMImpl  fiom  =  new  FIOMImpl ("A  FIOM"); 
fiom. setFE (feArray) ; 
fiom. setFE (feArray) ; 

FE  [  ]  testee  =  fiom. getFE () ; 

assertTrue (  Arrays . equals (  feArray,  testee 
testee [0 ]. getFIOM () ==f iom  && 
testee [1 ]. getFIOM () ==f iom  ); 

} 

public  void  test_f indFE_l ( )  { 

FE [ ]  feArray  =  new  FE [ ]  {  new  FEImpl(null, 

new  FEImpl(null, 

FIOMImpl  fiom  =  new  FIOMImpl ("A  FIOM"); 
fiom. setFE (feArray) ; 

assertTrue (  f iom. f indFE ( "fe  0")  ==  feArray 
f iom. f indFE ( "fe  a")  ==  null  ); 

} 

public  void  test_f eExists_true ( )  { 

assertEquals (  true,  f iomlmpl . f eExists ( " f e 

} 


null, 

null. 


)  && 


null, 

null. 


)  && 


null, 

null. 


[0]  && 


1")  ); 


"FE  1") , 
"FE  2")  } ; 


"FE  1") , 
"FE  2")  }; 


"FE  0") , 
"FE  1")  }; 
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public  void  test_f eExists_f alse ( )  { 

assertEquals (  false,  f iomlmpl . f eExists ( "a  fe  1")  ); 

} 

public  void  test_newFE_l  ()  throws  Exception  { 
int  c  =  fiom. feCount () ; 

FE  fe  =  fiom.newFE(  "a  new  FE"  ); 
assertTrue (  fe  ==  f iom. f indFE ( "a  new  FE" )  && 
fe.getFIOMO  ==  fiom  && 
f iom. feCount ( )  ==  c+1  ); 

} 

public  void  test_newFE_duplicate_l  ()  throws  Exception  { 
try  { 

FE  fe  =  fiom.newFE(  "a  new  FE"  ); 
fiom.newFE(  "a  new  FE"  ); 

fail (DuplicateKeyExcept ion . class . getName ( )  +  "  expected  but  not  thrown. 

} 

catch  (Exception  exc)  { 

assertEquals (  DuplicateKeyException . class,  exc . getClass ( )  ); 

} 


public  void  test_f indCCR_l ( )  throws  Exception  { 
String  systemName  =  "System  to  be  found"; 

String  ccrName  =  "CCR  Name  to  be  found"; 

String  urlString  =  "http://findme.com/found.xsd"; 


FE  [  ] 

feArray  =  new  FE [ ] 

{  new  FEImpl(null, 

null. 

"FE  0 

new  FEImpl(null, 

null. 

"FE  1 

FIOMImpl  fiom  =  new  FIOMImpl("A  FIOM"); 
fiom. setFE (feArray) ; 


FE  fe; 

FOR  for; 

//  level  1 

fe  =  feArray [0]; 

String  suffix  =  "0"; 

fe  =  fe.newChild(  "Child"  +  suffix  ); 

fcr  =  f e . createRootFEV (  "FEV"  +  suffix  ).createFCR(  "FCR"  +  suffix  ); 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/0 . xsd"  +  suffix)  ); 

//  level  1 

fe  =  feArray [1]; 


213 


suffix  =  "0"; 

fe  =  fe.newChild(  "Child"  +  suffix  ); 

fcr  =  f e . createRootFEV (  "FEV"  +  suffix  ).createFCR(  "FCR"  +  suffix  ); 
fcr.newCCR(  "System"  +  suffix,  "CCR"  +  suffix, 

new  URL ( "http : //a . com/0 . xsd"  +  suffix)  ); 

CCR  target  =  f cr . newCCR (systemName,  ccrName,  new  URL (urlString) ) ; 

assertTrue (  fiom. findCCR (systemName,  new  URL (urlString) )  ==  target  ); 


j  -k 


*  Compares  the  two  arrays,  equals  if  and  only  if 

*  obj 1 . length==obj2 . length  and 

*  for  each  objl[i],  there  exists  exactly  one  obj2[j]  such  that 

*  ob j 1 [ i ]. equals (obj2 [ i ] ) 

*  and 

*  for  each  obj2[i],  there  exists  exactly  one  objl[j]  such  that 

*  ob j2 [ i ]. equals (obj 1 [ i ] ) 

public  boolean  equalsUnordered (Ob ject [ ]  objl.  Object []  obj2)  { 
if  (objl . length ! =obj2 . length) 
return  false; 

ArrayList  listl  =  new  ArrayList (  Arrays . asList (obj 1 )  ); 

Iterator  iter 

for  (int  i=0;  i<obj2 . length;  i++)  { 


} 


} 

*/ 


/** 

*  Test  f indTranslation . 

*/ 

public  void  test_f indTranslation ( )  { 

String[]  trans  =  new  String[]  {  "a . f crl , a . ccrl=transl " , 

"a . f cr2 , a . ccr2=trans2 "  }; 

FIOMImpl  fiom  =  new  FIOMImplO; 
f iom. setTranslat ions (  trans  ); 

String []  testee  =  f iom. getTranslations ( )  ; 

assertTrue (  fiom. f indTranslation ( "a . f crl " ,  "a . ccrl "). equals ( "transl " )  ) 


/** 

*  Test  get/set  Translations. 
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*/ 

public  void  test_getsetTranslations ( )  { 

String[]  trans  =  new  String[]  {  "a. fcrl, a.ccrl=transl", 

"a . f cr2 , a . ccr2=trans2 "  }; 

FIOMImpl  fiom  =  new  FIOMImplO; 
f iom. setTranslat ions (  trans  ); 

String []  testee  =  f iom. getTranslations ( )  ; 

Arrays . sort (testee)  ; 

Arrays . sort (trans)  ; 

assertTrue (  Arrays . equals (  trans,  testee  )  ); 


/** 

*  Test  f indTranslation . 

*/ 

//public  void  test_f indTranslation 

public  void  test_registerCCR_l ( )  throws  Exception  { 

FIOM  fioml  =  new  FIOMImpl ( "my  name"); 

FE  fe  =  f ioml . newFE ( "FE" )  ; 

FEV  fev  =  fe . createRootFEV ( "ROOT" ) ; 

FOR  for  =  fev . createFCR ( "FOR" ) ; 

OCR  unregisteredl  =  fioml . newCCR (  "A",  "OCR  Al",  new  URL ( "http: //a.b. c/Al 
OCR  unregistered2  =  fioml . newCCR (  "A",  "OCR  A2",  new  URL ( "http : //a .b . c/A2 
int  countBef oreReg  =  fioml . unregisteredCCRCount () ; 
f ioml . registerCCR ( f cr ,  unregisteredl) ; 
assertTrue (  fioml . unregisteredCCRCount ( ) ==1 
&&  countBef oreReg==2 
&&  fcr.getCCRO  [ 0 ] ==unregisteredl 

)  ; 


}  //public  class  ZzzTest_FIOMImpl  extends  TestCase 

2 1 .  ZzzT  estOOMIDatabaselmpl.j  ava 

package  mil . navy . nps . cs . oomi . impl ; 

import  java. util.*; 

import  java.io.*; 

import  java.net.*; 

import  junit . framework . TestCase; 

import  mil . navy . nps . cs . oomi .* ; 

import  mil . navy . nps . cs . oomi . fiom. *; 
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import  mil . navy . nps . cs . oomi . exceptions . * ; 


public  class  ZzzTest_OOMIDatabaseImpl  extends  TestCase 

{ 


FIOMFactory  _factory  =  Factorylmpl . newFIOMFactory ( ) ; 

public  ZzzTest_OOMIDatabaseImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_OOMIDatabaseImpl (String  Name_) 

OOMIDatabase  oomiDb  =  null; 

String []  f iomNameArray  =  null; 

protected  void  setup ()  throws  Exception 

{ 

oomiDb  =  OOMIDatabaselmpl . loadFromFile ( " " ) ; 
f iomNameArray  =  new  String []  {  "1",  "2"  }; 

}  //protected  void  setup  () 

protected  void  tearDown  () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_OOMIDatabaseImpl . class . getName ()} ; 
junit . swingui . TestRunner .main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 


public  void  test_saveToFile_l ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "OOMIDatabaseImpl_test_saveToFile_l " ,  ".xml"); 

f ile . deleteOnExit  () ; 
oomiDb . newFIOM ( "New  FiOm" ); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 
assertEquals (  oomiDb,  db  ) ; 

} 

public  void  test_saveToFile_2_FIOMtoFE ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "OOMIDatabaseImpl_test_saveToFile_2_FIOMtoFE" ,  ".xml 
file . deleteOnExit ()  ; 
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oomiDb . newFIOM ( "New  FiOm" ); 
oomiDb . newFIOM ( "New  FiOm  A"); 

FIOM  fiom  =  oomiDb . newFIOM ( "  FIOM  1  ");  //  with  trailing,  beginning  and  double  space 
FE  fe  =  f iom. newFE (  "FIOM  1  FE  1"  ); 
f iom. newFE (  "FIOM  1  FE  2"  ); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 

FIOM[]  fiomsA  =  oomiDb . getFIOM () ; 

F I OM [ ]  fiomsB  =  db . getFIOM () ; 

FIOM  fiomB  =  db . f indFIOM ( "  FIOM  1  "); 

FE  feB  =  fiomB. findFE ("FIOM  1  FE  1"); 
assertTrue (  fiomsA. length  ==  fiomsB . length  &&  f eB . getFIOM ( )  ==  fiomB  ); 

} 

public  void  test_saveToFile_2_FIOM_UnregisteredCCRs ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "test_saveToFile_2_FIOM_UnregisteredCCRs " ,  ".xml"); 

f ile . deleteOnExit  () ; 
oomiDb . newFIOM ( "New  FiOm" ); 
oomiDb . newFIOM ( "New  FiOm  A"); 

FIOM  fiom  =  oomiDb . newFIOM ( "  FIOM  1  ");  //  with  trailing,  beginning  and  double  space 

OCR  ccrlA  =  fiom.newCCR(  "Sys  A",  "OCR  1A",  new  URL (  "http : //a . b . c/lA" )  ); 

OCR  ccrlB  =  fiom.newCCR(  "Sys  A",  "OCR  IB",  new  URL (  "http: //a.b.c/lB" )  ); 

FE  fe  =  fiom. newFE (  "FIOM  1  FE  1"  ); 
fiom. newFE (  "FIOM  1  FE  2"  ); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 

FIOM  loadedFioml  =  db . f indFIOM ( "  FIOM  1  "); 

OCR  loadedCCRIA  =  loadedFioml . findUnregisteredCCR (ccrlA. getSystemName () , 

ccrlA. getCCRName ( )  ); 

OCR  loadedCCRIB  =  loadedFioml . findUnregisteredCCR (ccrlB . getSystemName () , 

ccrlB . getCCRName ( )  ); 

assertTrue (  loadedCCRIA . getSystemName () .equals (ccrlA. getSystemName () ) 

&&  loadedCCRIA. getCCRName ( ) . equals (ccrlA. getCCRName () ) 

&&  loadedCCRIA . getXMLNameSpaceURI () .equals (ccrlA. getXMLNameSpaceURI () ) 

&&  loadedCCRIB . getSystemName ( ) . equals (ccrlB . getSystemName () ) 

&&  loadedCCRIB . getCCRName ( ) . equals (ccrlB . getCCRName () ) 

&&  loadedCCRIB . getXMLNameSpaceURI ( ) . equals (ccrlB . getXMLNameSpaceURI ( ) ) 

)  ; 

} 

public  void  test_saveToFile_FIOMtoFEV_l ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "OOMIDatabaseImpl_test_saveToFile_FIOMtoFEV_l " ,  ".xml"); 

file . deleteOnExit  () ; 
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oomiDb . newFIOM ( "New  FiOm" ); 

FIOM  fiom  =  oomiDb . newFIOM ( "FIOM  1"); 

FE  fe  =  f iom. newFE (  "FIOM  1  FE  1"  ); 

FEV  fev  =  f e . createRootFEV (  "FIOM  1  FE  1  FEV  1"  ); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 

FIOM[]  fiomsA  =  oomiDb . getFIOM () ; 

FIOM[]  fiomsB  =  db . getFIOM () ; 

FIOM  fiomB  =  db . f indFIOM ( "FIOM  1"); 

FE  feB  =  fiomB. findFE ("FIOM  1  FE  1"); 

FEV  fevB  =  feB. findFEV ("FIOM  1  FE  1  FEV  1"); 

assertTrue  (  f evB . getFE ( ) ==f eB  ); 

} 

public  void  test_saveToFile_FIOMtoFCR_l ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "OOMIDatabaseImpl_test_saveToFile_l " ,  ".xml"); 

f ile . deleteOnExit  () ; 
oomiDb . newFIOM ( "New  FiOm" ); 

FIOM  fiom  =  oomiDb . newFIOM ( "FIOM  1"); 

FE  fe  =  fiom. newFE (  "FIOM  1  FE  1"  ); 

FEV  fev  =  fe. createRootFEV (  "FIOM  1  FE  1  FEV  1"  ); 

FOR  for  =  fev. createFCR ("FIOM  1  FE  1  FEV  1  fcr  1"); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 

FIOM[]  fiomsA  =  oomiDb . getFIOM () ; 

FIOM [ ]  fiomsB  =  db . getFIOM () ; 

FIOM  fiomB  =  db . f indFIOM ( "FIOM  1"); 

FE  feB  =  fiomB. findFE ("FIOM  1  FE  1"); 

FEV  fevB  =  feB. findFEV ("FIOM  1  FE  1  FEV  1"); 

assertEquals (  "FIOM  1  FE  1  FEV  1  fcr  1",  f evB . getFCR ( ) . getFCRName ( )  ); 

//  f cr . getFEV ( ) ==fevB  ); 


/** 

*  Checks  if  the  FEV  property  of  an  FCR 

*  is  properly  set  after  loading  from  file. 

*/ 

public  void  test_saveToFile_FIOMtoFCR_2 ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "OOMIDatabaseImpl_test_saveToFile_l " ,  ".xml"); 

file . deleteOnExit ()  ; 
oomiDb . newFIOM ( "New  FiOm" ); 
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FIOM  fiom  =  oomiDb . newFIOM ( "FIOM  1"); 

FE  fe  =  f iom. newFE (  "FIOM  1  FE  1"  ); 

FEV  fev  =  f e . createRootFEV (  "FIOM  1  FE  1  FEV  1"  ); 

FOR  fcr  =  fev. createFCR ("FIOM  1  FE  1  FEV  1  fcr  1"); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 
OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 
FIOM[]  fiomsA  =  oomiDb . getFIOM () ; 

FIOM[]  fiomsB  =  db . getFIOM () ; 

FIOM  fiomB  =  db . f indFIOM ( "FIOM  1"); 

FE  feB  =  fiomB. findFE ("FIOM  1  FE  1"); 

FEV  fevB  =  feB. findFEV ("FIOM  1  FE  1  FEV  1"); 

assertTrue (  f evB . getFCR ( ) . getFEV ( ) ==f evB  ); 


/** 

*  Checks  if  CCR  is  properly  restored  from  storage. 

*/ 

public  void  test_saveToFile_FIOMtoCCR_l ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "OOMIDatabaseImpl_test_saveToFile_FIOMtoCCR_l-" ,  ".xml 
f ile . deleteOnExit  () ; 
oomiDb . newFIOM ( "New  FiOm" ); 

FIOM  fiom  =  oomiDb . newFIOM ( "FIOM  1"); 

FE  fe  =  fiom. newFE (  "FIOM  1  FE  1"  ); 

FEV  fev  =  fe. createRootFEV (  "FIOM  1  FE  1  FEV  1"  ); 

FCR  fcr  =  fev. createFCR ("FIOM  1  FE  1  FEV  1  fcr  1"); 

CCR  ccr  =  fcr . newCCR ("System",  "FIOM  1  FE  1  FEV  1  fcr  1  ccr  1",  null  ); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 

FIOM[]  fiomsA  =  oomiDb . getFIOM () ; 

FIOM [ ]  fiomsB  =  db . getFIOM () ; 

FIOM  fiomB  =  db . f indFIOM ( "FIOM  1"); 

FE  feB  =  fiomB. findFE ("FIOM  1  FE  1"); 

FEV  fevB  =  feB. findFEV ("FIOM  1  FE  1  FEV  1"); 

FCR  f crB  =  fevB. getFCR () ; 

CCR  ccrB  =  ( f crB . getCCR ( ) )  [0]  ; 

assertEquals (  "FIOM  1  FE  1  FEV  1  fcr  1  ccr  1",  ccrB . getCCRName ( )  ); 


/** 

*  Checks  if  CCR  is  properly  restored  from  storage. 

*/ 

public  void  test_saveToFile_FIOMtoCCR_2 ( )  throws  Exception  { 
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File  file  =  File . createTempFile ( "00MIDatabaseImpl_test_saveToFile_FI0MtoCCR_2-" ,  ".xml"); 

f ile . deleteOnExit ()  ; 
oomiDb . newFIOM ( "New  FiOm" ); 

FIOM  fiom  =  oomiDb . newFIOM ( "FIOM  1"); 

FE  fe  =  f iom. newFE (  "FIOM  1  FE  1"  ); 

FEV  fev  =  f e . createRootFEV (  "FIOM  1  FE  1  FEV  1"  ); 

FOR  for  =  fev. createFCR ("FIOM  1  FE  1  FEV  1  for  1"); 

OCR  ccr  =  for . newCCR ("System",  "FIOM  1  FE  1  FEV  1  for  1  ccr  1",  null  ); 
for . newCCR ( "System" ,  "FIOM  1  FE  1  FEV  1  for  1  ccr  2",  null  ); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 

FIOM [ ]  fiomsB  =  db . getFIOM ( ) ; 

FIOM  fiomB  =  db . f indFIOM ( "FIOM  1"); 

FE  feB  =  fiomB. findFE ("FIOM  1  FE  1"); 

FEV  fevB  =  feB. findFEV ("FIOM  1  FE  1  FEV  1"); 

FOR  f crB  =  f evB . getFCR ( ) ; 

CCR  ccrB  =  ( f crB . getCCR ( ) )  [0]  ; 

assertTrue (  ccrB . getFCR () ==f crB  ); 


/** 

*  Checks  if  FCRSchema  is  properly  restored  from  storage. 

*  Tests  if  the  Parent  property  of  the  attributes  are  properly  restored. 

*  Other  properties  should  be  properly  restored,  since  they  are  "primitive" 

*  types. 

*/ 

public  void  test_saveToFile_FIOMtoFCRSchema_l ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "OOMIDatabaseImpl_test_saveToFile_l " ,  ".xml"); 

file . deleteOnExit () ; 
oomiDb . newFIOM ( "New  FiOm" ) ; 

FIOM  fiom  =  oomiDb . newFIOM ( "FIOM  1"); 

FE  fe  =  fiom. newFE (  "FIOM  1  FE  1"  ); 

FEV  fev  =  fe. createRootFEV (  "FIOM  1  FE  1  FEV  1"  ); 

FOR  for  =  fev. createFCR ("FIOM  1  FE  1  FEV  1  fcr  1"); 

FCRSchema  fcrSchema  =  f cr . getFCRSchema ( ) ; 

f crSchema . setType (_factory .makeTypeName ( "The . root . type" )  ) ; 

Attribute  fcrAttr_l  =  __f actory . makeAttribute (null ,  "fcrAttr_l 

factory .makeTypeName ("anyType" ) )  ; 

fcrSchema . addAttribute (  fcrAttr_l  ); 
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Attribute  fcrAttr_2  =  _f  actory . makeAttribute (null ,  "fcrAttr_2 

factory .makeTypeName ("anyType" ) ) ; 

f crSchema . addAttribute (  fcrAttr_2  ); 

f crAttr_2 . newChild ( "a" ,  _f actory .makeTypeName ("tl") ) ; 

f crAttr_2 . newChild ( "b" ,  _f  actory .makeTypeName ( "t2 " ) ) ; 

CCR  ccr  =  fcr.newCCR ("System",  "FIOM  1  FE  1  FEV  1  fcr  1  ccr  1",  null  ); 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 

FIOM[]  fiomsA  =  oomiDb . getFIOM () ; 

FIOM [ ]  fiomsB  =  db . getFIOM () ; 

FIOM  fiomB  =  db . f indFIOM ( "FIOM  1"); 

FE  feB  =  fiomB. findFE ("FIOM  1  FE  1"); 

FEV  fevB  =  feB. findFEV ("FIOM  1  FE  1  FEV  1"); 

FCR  f crB  =  f evB . getFCR ( ) ; 

CCR  ccrB  =  ( f crB . getCCR ( ) ) [0]; 

FCRSchema  loadedFCRSchema  =  f crB . getFCRSchema ( ) ; 

//Attribute  loadedFcrRootAttr  =  loadedFCRSchema . getRootAttribute () ; 

Attribute []  loadedFcrAttr  =  loadedFCRSchema . getAttribute () ; 

Attribute []  secondLevel  =  loadedFcrAttr [ 1 ]. getChild ()  ; 
assertTrue (  loadedFCRSchema . getType ( ) . equals (_factory .makeTypeName ( "The . root . type" ) )  && 
loadedFcrAttr [ 0 ] . equals (fcrAttr_l )  && 
loadedFcrAttr [ 1 ] . equals (fcrAttr_2)  ); 


/** 

*  Checks  if  CCRSchema  is  properly  restored  from  storage. 

*  Tests  if  the  Parent  property  of  the  attributes  are  properly  restored. 

*  Other  properties  should  be  properly  restored,  since  they  are  "primitive" 

*  types. 

*/ 

public  void  test_saveToFile_FIOMtoCCRSchema_l ( )  throws  Exception  { 

File  file  =  File . createTempFile ( "OOMIDatabaseImpl_test_saveToFile_l " ,  ".xml"); 

f ile . deleteOnExit ()  ; 
oomiDb . newFIOM ( "New  FiOm" ) ; 

FIOM  fiom  =  oomiDb . newFIOM ( "FIOM  1"); 

FE  fe  =  f iom. newFE (  "FIOM  1  FE  1"  ); 

FEV  fev  =  f e . createRootFEV (  "FIOM  1  FE  1  FEV  1"  ); 

FCR  fcr  =  fev. createFCR ("FIOM  1  FE  1  FEV  1  fcr  1"); 

FCRSchema  f crSchema  =  fcr . getFCRSchema () ; 

f crSchema . setType (_factory .makeTypeName ( "The . root . type" ) ) ; 

Attribute  fcrAttr_l  =  _f actory . makeAttribute (null ,  "fcrAttr_l 

factory .makeTypeName ("anyType") ) ; 

f crSchema . addAttribute (  fcrAttr_l  ); 
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Attribute  fcrAttr_2  =  _f  actory . makeAttribute (null ,  "fcrAttr_2 

factory .makeTypeName ("anyType" ) ) ; 

f crSchema . addAttribute (  fcrAttr_2  ); 

f crAttr_2 . newChild ( "a" ,  _f actory .makeTypeName ("tl") ) ; 

f crAttr_2 . newChild ( "b" ,  _f  actory .makeTypeName ( "t2 " ) ) ; 

CCR  ccr  =  fcr.newCCR ("System",  "FIOM  1  FE  1  FEV  1  fcr  1  ccr  1",  null  ); 

CCRSchema  ccrSchema  =  ccr . getCCRSchema ( ) ; 

ccrSchema . setType (_factory .makeTypeName ( "The . root . type" ) ) ; 

Attribute  ccrAttr_l  =  _f actory . makeAttribute (null ,  "ccrAttr_l 

factory .makeTypeName ("anyType") ) ; 

ccrSchema . addAttribute (ccrAttr_l ) ; 

Attribute  ccrAttr_2  =  _f  actory . makeAttribute (null ,  "ccrAttr_2 

factory .makeTypeName ("anyType") ) ; 

ccrSchema . addAttribute (ccrAttr_2) ; 

ccrAttr_2 . newChild ( "a" ,  _f actory .makeTypeName ( "tl " ) ) ; 
ccrAttr_2 . newChild ( "b" ,  _f actory .makeTypeName ( "t2 " ) ) ; 

( (OOMIDatabaselmpl) oomiDb) . saveToFile (file . getAbsolutePath ( ) ) ; 

OOMIDatabase  db  =  OOMIDatabaselmpl . loadFromFile (file . getAbsolutePath ()) ; 

FIOM[]  fiomsA  =  oomiDb . getFIOM () ; 

F I OM [ ]  fiomsB  =  db . getFIOM () ; 

FIOM  fiomB  =  db . f indFIOM ( "FIOM  1"); 

FE  feB  =  fiomB. findFE ("FIOM  1  FE  1"); 

FEV  fevB  =  feB. findFEV ("FIOM  1  FE  1  FEV  1"); 

FCR  f crB  =  f evB . getFCR ( ) ; 

CCR  ccrB  =  ( f crB . getCCR ( ) )  [0]  ; 

CCRSchema  loadedCCRSchema  =  ccrB . getCCRSchema () ; 

Attribute []  loadedCcrAttr  =  loadedCCRSchema . getAttribute () ; 

Attribute []  secondLevel  =  loadedCcrAttr [ 1 ]. getChild ()  ; 
assertTrue (  loadedCCRSchema . getType ( ) . equals (_factory .makeTypeName ( "The . root . type" ) )  && 
loadedCcrAttr [ 0 ] . equals (ccrAttr_l )  && 
loadedCcrAttr [ 1 ] . equals (ccrAttr_2 )  ); 


public  void  test_l()  { 

assertEquals (oomiDb . f indFIOM ( "no  such  fiom"),  null); 


/** 

*  Tests  the  empty  case. 

*/ 

public  void  test_empty_count ( )  { 

assertEquals (0,  oomiDb. fiomCount () ) ; 

} 
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public  void  test_newFIOM_l ( )  throws  Exception  { 
int  c  =  oomiDb . f iomCount ( ) ; 
oomiDb . newFIOM ( "New  FiOm" ); 
assertEquals (1,  oomiDb. fiomCount () ) ; 

} 

public  void  test_f iomExists_true ( )  throws  Exception  { 
oomiDb . newFIOM ( "New  FiOm" ) ; 

assertTrue  (  oomiDb . fiomExists ( "new  fioM")  && 

! oomiDb . fiomExists ( "a" )  && 

! oomiDb . fiomExists ("")); 

} 

public  void  test_newFIOM_duplicate_l ( )  throws  Exception  { 
oomiDb . newFIOM ( "New  FiOm" ) ; 
int  c  =  oomiDb . fiomCount ()  ; 
try  { 

oomiDb . newFIOM ( "New  FiOm" ) ; 

fail ( "Exception  expected,  but  was  not  raised"); 

} 

catch  (Exception  e)  { 

assertEquals (c,  oomiDb . fiomCount ( ) ) ; 


/** 

*  Test  the  case-insensitive  find  of  existing  FIOM. 

*/ 

public  void  test_f indFIOM_l ( )  throws  Exception  { 
int  c  =  oomiDb . fiomCount ()  ; 
oomiDb . newFIOM ( "New  FiOm  1"); 
oomiDb . newFIOM ( "New  FiOm" ) ; 
oomiDb . newFIOM ( "New  FiOm  2"); 

assertTrue (oomiDb . findFIOM ( "new  fiom")  !=  null); 

} 

public  void  test_getFIOM_empty_array ( )  { 

assertEquals (  0,  oomiDb . getFIOM (). length  ); 

} 

public  void  test_getFIOM_nonempty_array ( )  throws  OOMIException  { 
FIOM[]  fioms  =  new  FIOMImpl [ fiomNameArray . length] ; 
for  (int  i=0;  i<f iomNameArray . length;  i++)  { 

fioms [i] =oomiDb . newFIOM (fiomNameArray [i] ) ; 

} 

assertTrue (  Arrays . equals (fioms,  oomiDb . getFIOM () )  ); 

} 

public  void  test_equals_null ( )  { 
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assertTrue  (  !  oomiDb . equals (null )  ); 

} 

public  static  void  pi (String  m)  { 

System. out . print In (m) ; 

} 

}  //public  class  ZzzTest_OOMIDatabaseImpl  extends  TestCase 

22.  ZzzTestSchemalmpl.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  junit . framework . TestCase; 
import  mil . navy . nps . cs . oomi . * ; 
import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

public  class  ZzzTest_SchemaImpl  extends  TestCase 

{ 


public  ZzzTest_SchemaImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_SchemaImpl (String  Name_) 

protected  void  setup () 

{ 

}  //protected  void  setup  () 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_SchemaImpl . class . getName () } 
junit . swingui . Test Runner . main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

FIOMFactory  _factory  =  Factorylmpl . factory () ; 

public  void  test_f indAttribute_l ( )  throws  Exception  { 

Schema  s  =  new  Schemalmpl ( ) ; 
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Attribute  attr 


Attribute 

Attribute 

Attribute 

Attribute 

Attribute 


=  s . addAttribute (  "The  name",  _f actory . makeTypeName ( "The  Type")); 
attr_l  =  attr . newChild  (  "namel",  _f actory . makeTypeName ( "type" )) ; 
attr_l_l  =  att r_l . newChild ( "namel-1 " , _f actory . makeTypeName ( "typel-1 " ) ) ; 
attr_2  =  attr . newChild (  "name2",  _f actory . makeTypeName ( "type" )) ; 
attr_3  =  attr . newChild (  "The  name",  _f actory . makeTypeName ( "type" )) ; 
attr_4  =  attr . newChild (  "The  name  4",  _f actory . makeTypeName ( "type" )) ; 


Attribute 
Type" ) ) ; 

Attribute 

Attribute 

Attribute 

Attribute 

Attribute 


a  =  _f actory . makeAttribute (  null,  "The  name",  _f actory .makeTypeName (" The 

a_l  =  a.newChild(  "namel",  _f actory . makeTypeName ( "type" )) ; 
a_l_l  =  a_l . newChild ( "namel-1 " , _f actory . makeTypeName ( "typel-1 " ) )  ; 
a_2  =  a.newChild{  "name2",  _f actory . makeTypeName ( "type" )) ; 
a_3  =  a.newChild(  "The  name",  _f actory . makeTypeName ( "type" )) ; 
a_4  =  a.newChild(  "The  name  4",  _f actory . makeTypeName ( "type" )) ; 


assertTrue ( 


) 


s . f indAttribute (a_l_l) .equals (attr_l_l) 
s . f indAttribute (a_l)  .equals (attr_l)  )  ; 


&& 


public  void  test_f indAttribute_2 ( )  throws  Exception  ( 
Schema  s  =  new  Schemalmpl{) ; 


Attribute 

Attribute 

Attribute 

Attribute 

Attribute 

Attribute 


attr  =  s . addAttribute (  "The  name",  _f actory . makeTypeName ( "The  Type")); 
attr_l  =  attr . newChild (  "namel",  _f actory . makeTypeName ( "type" )) ; 
att r_l_l  =  att r_l . newChild ( "namel-1 " , _f actory . makeTypeName ( "typel-1 " ) ) ; 
attr_2  =  attr . newChild (  "name2",  _f actory . makeTypeName ( "type" )) ; 
attr_3  =  attr . newChild (  "The  name",  _f actory . makeTypeName ( "type" )) ; 
attr_4  =  attr . newChild (  "The  name  4",  _f actory . makeTypeName ( "type" )) ; 


Attribute 
Type" ) ) ; 

Attribute 

Attribute 

Attribute 

Attribute 

Attribute 


a  =  _f actory . makeAttribute (  null,  "The  name",  _f actory .makeTypeName (" The 

a_l  =  a.newChild(  "namel",  _f actory . makeTypeName ( "type" )) ; 

a_l_l  =  a_l . newChild ( "namel-1 " , _f actory . makeTypeName ( "typel-1 " ) ) ; 

a_2  =  a.newChild(  "name2",  _f actory . makeTypeName ( "type" )) ; 

a_3  =  a.newChild(  "The  name  NOTFOUND",  _f actory . makeTypeName ( "type" )) ; 

a_4  =  a.newChild(  "The  name  4",  _f actory . makeTypeName ( "type" )) ; 


assertTrue (  s . f indAttribute ( a _ 3 )  ==  null  ); 

} 


}  //public  class  ZzzTest_SchemaImpl  extends  TestCase 
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23.  ZzzTestTypeNamelmpl.java 


package  mil . navy . nps . cs . oomi . impl ; 

import  junit . framework . TestCase; 
import  mil . navy . nps . cs . oomi . f iom. * ; 

public  class  ZzzTest_TypeNameImpl  extends  TestCase 

{ 


public  ZzzTest_TypeNameImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_TypeNameImpl (String  Name_) 

protected  void  setup () 

{ 

}  //protected  void  setup () 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_TypeNameImpl . class . getName () } 
junit . swingui . TestRunner .main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

public  static  void  p (String  m)  { 

System. out . print In (m) ; 

} 


FIOMFactory  f  =  Factorylmpl . factory () ; 
public  void  test_equals_l ( )  { 

TypeName  tl  =  f .makeTypeName (  String. class  ); 
TypeName  t2  =  f .makeTypeName (  String. class  ); 
assertTrue  (  1 1 . equals (t2 )  ); 


} 

public  void  test_equals_2 ( )  { 

TypeName  tl  =  f .makeTypeName (  String. class  ); 
TypeName  t2  =  f .makeTypeName (  "a"  ); 
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assertTrue (  ! tl . equals (t2 )  ); 

} 

public  void  test_hashCode_l ( )  { 

TypeName  tl  =  f .makeTypeName (  " java . lang . String"  ); 

TypeName  t2  =  f .makeTypeName (  String . class . getName ( )  ); 

assertTrue (  t 1 . hashCode ( )  ==  t2 . hashCode ( )  ); 

} 

public  void  test_hashCode_2 ( )  { 

TypeName  tl  =  f .makeTypeName (  " java . lang . String"  ); 

TypeName  t2  =  f .makeTypeName (  String . class . getName ( )  +  "1"  ); 
assertTrue (  t 1 . hashCode ( )  !=  t2 . hashCode ( )  ); 

} 

public  void  test_isArray_l ( )  { 

assertTrue (  !  f .makeTypeName (String . class) . isArray ( )  ); 

} 

public  void  test_isArray_2 ( )  { 

assertTrue (  f .makeArrayTypeName (String . class,  1). isArray ()  ); 

} 

public  void  test_isPrimitive_l ( )  { 

assertTrue (  ! f .makeArrayTypeName (String . class,  1 ) . isPrimitive ( )  ) 

} 

public  void  test_isPrimitive_2 ( )  { 

assertTrue (  ! f .makeArrayTypeName (Integer . TYPE,  1 ). isPrimitive ( )  ) 

} 

public  void  test_isPrimitive_3 ( )  { 

TypeName  t  =  f .makeTypeName (Integer . TYPE) ; 
assertTrue (  t . isPrimitive ( )  ); 

} 

public  void  test_isPrimitive_4 ( )  { 

assertTrue (  ! f .makeTypeName (Integer . class) . isPrimitive ( )  ); 

} 

public  void  test_duplicate_l ( )  { 

TypeName  t  =  f .makeTypeName (  "abc"  ); 

TypeName  clone  =  t.copyO; 

assertTrue (  t!=clone  &&  t . equals (clone)  ); 

} 

public  void  test_clone_l ( )  { 

TypeName  t  =  f .makeTypeName (  "abc"  ); 

TypeName  clone  =  (TypeName)  ( (TypeNamelmpl) t)  . clone ()  ; 
assertTrue (  t!=clone  &&  t . equals (clone)  ); 

} 

}  //public  class  ZzzTest_TypeNameImpl  extends  TestCase 
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APPENDIX  B.  TRANSLATION  GENERATOR  SOURCE  CODE 


A.  PACKAGE:  mil.navy.nps.cs.oomi.translator 

1.  AttributesTreeModel.java 

package  mil . navy . nps . cs . oomi . impl ; 

import  junit . framework . TestCase; 
import  mil . navy . nps . cs . oomi . f iom. * ; 

public  class  ZzzTest_TypeNameImpl  extends  TestCase 

{ 


public  ZzzTest_TypeNameImpl (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_TypeNameImpl (String  Name_) 

protected  void  setup () 

{ 

}  //protected  void  setup  () 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_TypeNameImpl . class . getName ()} ; 
junit . swingui . Test Runner . main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

public  static  void  p (String  m)  { 

System. out . print In (m) ; 

} 


FIOMFactory  f  =  Factorylmpl . factory () ; 
public  void  test_equals_l ( )  { 

TypeName  tl  =  f .makeTypeName (  String. class  ); 
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TypeName  t2  =  f .makeTypeName (  String. class  ); 
assertTrue  (  1 1 . equals (t2 )  ); 

} 

public  void  test_equals_2 ( )  { 

TypeName  tl  =  f .makeTypeName (  String. class  ); 

TypeName  t2  =  f .makeTypeName (  "a"  ); 
assertTrue  (  ! tl . equals (t2 )  ); 

} 

public  void  test_hashCode_l ( )  { 

TypeName  tl  =  f .makeTypeName (  " java . lang . String"  ); 

TypeName  t2  =  f .makeTypeName (  String . class . getName ( )  ); 
assertTrue (  t 1 . hashCode ( )  ==  t2 . hashCode ( )  ); 

} 

public  void  test_hashCode_2 ( )  { 

TypeName  tl  =  f .makeTypeName (  " java . lang . String"  ); 

TypeName  t2  =  f .makeTypeName (  String . class . getName ( )  +  "1"  ); 
assertTrue (  t 1 . hashCode ( )  !=  t2 . hashCode ( )  ); 

} 

public  void  test_isArray_l ( )  { 

assertTrue (  !  f .makeTypeName (String . class ). isArray ( )  ); 

} 

public  void  test_isArray_2 ( )  { 

assertTrue (  f .makeArrayTypeName (String . class,  l).isArray()  ); 

} 

public  void  test_isPrimitive_l ( )  { 

assertTrue  (  ! f .makeArrayTypeName (String . class,  1 )  . isPrimitive ( )  ) 

} 

public  void  test_isPrimitive_2 ( )  { 

assertTrue (  ! f .makeArrayTypeName (Integer . TYPE,  1 ). isPrimitive ( )  ) 

} 

public  void  test_isPrimitive_3 ( )  { 

TypeName  t  =  f .makeTypeName (Integer . TYPE) ; 
assertTrue (  t . isPrimitive ( )  ); 

} 

public  void  test_isPrimitive_4 ( )  { 

assertTrue  (  ! f .makeTypeName (Integer . class)  . isPrimitive ( )  ); 

} 

public  void  test_duplicate_l ( )  { 

TypeName  t  =  f .makeTypeName (  "abc"  ); 

TypeName  clone  =  t.copyO; 

assertTrue (  t!=clone  &&  t . equals (clone)  ); 

} 
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public  void  test_clone_l  ( )  { 

TypeName  t  =  f .makeTypeName (  "abc"  ); 

TypeName  clone  =  (TypeName) ( (TypeNamelmpl) t) . clone () ; 
assertTrue (  t!=clone  &&  t . equals (clone)  ); 

} 

}  //public  class  ZzzTest_TypeNameImpl  extends  TestCase 

2.  AttributeTranslationMethod.java 

package  mil . navy . nps . cs . oomi . translator; 

/** 

*  A  method  definition  that  defines  a  FIOM  attribute  translation. 

*  Contains  additional  information  required  to  generate  translations, 

*  specifically,  contains  the  target  TranslationAttribute  that  this 

*  TranslationMethodDef inition  is  meant  for. 

*/ 

public  class  AttributeTranslationMethod  extends  MethodDef inition  { 

/** 

*  The  target  attribute  that  this  method  is  meant  to  translate  to. 
*/ 

protected  TranslationAttribute  _target  =  null; 


public  AttributeTranslationMethod ( )  { 

} 

public  AttributeTranslationMethod ( 

String  modifiers. 

String  returnType, 

String  methodName, 

TranslationAttribute  targetAttribute)  { 
super (modifiers ,  returnType,  methodName); 

_target  =  targetAttribute; 

} 

public  TranslationAttribute  getTargetAttribute ( )  { 

return  _target; 


3.  ClassDefinition.java 

package  mil . navy . nps . cs . oomi . translator; 
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import  java. util.*; 


/** 

*  <p> 

*  An  instance  of  this  class  defines  a  Java  class. 

*  Currently,  does  not  support  inner  classes. 

*  @author  LSC 

*  (Aversion  1 . 0 

*/ 

public  class  ClassDef inition  { 

/** 

*  Modifiers  for  this  ClassDef inition . 

*/ 

protected  String  _modifiers  = 

/** 

*  Name  of  the  Java  class  defined  by  this  object. 

V 

protected  String  _name  =  null; 

#** 

*  Name  of  the  parent  Java  class  for  the  class  defined, 

*  defaults  to  the  Java  base  class:  Object. 

V 

protected  String  _parentName  =  Ob ject . class . getName () ; 

/** 

*  List  of  MethodDef inition  instances. 

V 

protected  List  _methods  =  new  LinkedList ( ) ; 

/** 

*  Custom  code  segment  for  field  declarations  managed  by  the  user. 
*/ 

protected  List  _userManagedFields  =  new  LinkedList () ; 
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/** 

*  Custom  code  segment  for  method  definitions  managed  by  the  user. 
*/ 

protected  List  _userManagedMethods  =  new  LinkedList ( ) ; 


/** 

*  Constructor,  if  parentName  is  null,  the  parent  of  this  ClassDef inition 

*  will  be  the  default  Java  Object  class. 

*/ 

public  ClassDef inition (String  className,  String  parentName)  { 
setParentName (parentName) ; 
setName (className) ; 


public  void  setModifiers (  String  modifiers  )  { 

this ._modif iers  =  modifiers; 

} 

public  String  getModif iers ( )  { 

return  this ._modif iers; 

} 

public  void  setParentName (  String  parentName  )  { 

if  (parentName==null ) 

this ._parentName  =  Ob ject . class . getName () ; 
else 

this ._parentName  =  parentName; 

} 

public  String  getParentName ( )  { 

return  this ._parentName; 

} 

public  void  setName (  String  className  )  { 

this._name  =  className; 

} 

public  String  getName ()  { 

return  this._name; 

} 

public  void  addMethods (  List  methods  )  { 

this ._methods . addAll (methods )  ; 

} 

public  void  addMethod (  MethodDef inition  method  )  { 

this ._methods . add (method) ; 

} 

public  void  setUserManagedFields (List  userFields)  { 
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this ._userManagedFields . addAll (userFields) ; 

} 

public  MethodDef inition [ ]  methodsToArray ( )  { 

int  size  =  this ._methods . size () ; 
if  (size>0)  { 

return  (MethodDef inition []  ) 

this ._methods . toArray (new  MethodDef inition [ size] ) ; 

} 

else 

return  null; 

} 

public  String []  userManagedFieldsToArray ( )  { 

int  size  =  this ._userManagedFields . size ()  ; 
if  (size>0) 

return  (String [])  this ._userManagedFields . toArray (new  String [ size] ) ; 
else 

return  null; 

} 

} 

4.  GeneratorUI.java 

package  mil . navy . nps . cs . oomi . translator; 

import  java.awt.*; 
import  java . awt . event . * ; 
import  javax . swing . * ; 
import  javax . swing . event . * ; 
import  java.io.*; 
import  java . util . EventObject ; 

import  mil . navy . nps . cs . oomi . f iom. * ; 
import  mil . navy . nps . cs . babel . plugin . * ; 

/** 

*  A  UI  factory  for  the  Translation  generator. 

*/ 

public  class  GeneratorUI  { 

protected  GeneratorUI ( )  { 

} 
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/** 

*  Creates  a  TranslationGeneratorPlugin  object  that  handles  the  user 

*  interface  to  perform  mapping  between  FCR  and  CCR  attributes. 

*  The  attribute  mappings  between  FCR  and  CCR  are  updated  to  the  specified 

*  CCR  object  parameter. 

*  @param  container  The  JPanel  that  the  user  interface  is  to  be  displayed  on. 

*  If  this  parameter  is  null,  this  method  will  create  a  new 

*  JPanel. 

*  @param  fcr  The  FCR  for  the  translation  skeleton  to  be  generated. 

*  The  following  are  required: 

*  <ol> 

*  <li>  f cr . getFCRSchema ( )  shall  return  a  FCRSchema  object 

*  with  all  the  attributes  properly  set. 

*  <li>  f cr . get JavaClassName ( )  shall  return  a  class  name  of  a 

*  compiled  class  accessible  to  the  TranslationGeneratorPlugin 

*  object  that  is  to  be  returned  from  this  method  invocation. 

*  <li>  f cr . getFEV ( ) . getFE ( ) . getFIOM ( )  shall  return  a  valid  reference 

*  to  the  FIOM  in  use. 


*  </ ol> 

*  @param  ccr  The  CCR  for  the  translation  skeleton  to  be  generated. 

*  The  following  are  required: 

*  <ol> 

*  <li>  ccr . get JavaClassName ( )  shall  return  a  class  name  of  a 

*  compiled  class  accessible  to  the  TranslationGeneratorPlugin 

*  object  that  is  to  be  returned  from  this  method  invocation. 

*  <li>  ccr . getCCRSchema ( )  shall  return  a  CCRSchema  object 

*  with  all  the  attributes  properly  set, 

*  including  MinOccurs  and  MaxOccurs  properties  for  each 

*  attribute. 


*  </ol> 

*  @param  translationPackageNameFormat  The  format  for  the  package  name  of  the 

*  translation  class  to  be  generated. 

*  @return  Returns  a  new  TranslationGeneratorPlugin  object. 

*/ 


public  static  mil . navy . nps . cs . babel . plugin . TranslationGeneratorPlugin 

makePlugin (JPanel  container,  FCR  fcr,  CCR  ccr, 

translat ionPackageNameP refix) 

throws  mil . navy . nps . cs . oomi . exceptions . IntrospectionException, 
ClassNotFoundException  { 

return  new  Plugin (  container,  fcr,  ccr,  translationPackageNamePref ix  ); 

} 


static  class  Plugin  implements  mil . navy . nps . cs .babel .plugin . TranslationGeneratorPlugin 


String 
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FCR  _fcr; 

FIOM  _f iom; 

CCR  _ccr ; 

/** 

*  The  package  name  prefix  of  the  class  to  be  generated. 

*/ 

String  _packageNamePref ix; 

Class  fcrClass; 

Class  ccrClass; 

TranslationMap  fcrToCcr; 

TranslationMap  ccrToFcr; 

TranslationMapTableModel  f crToCcrModel ; 

Trans lationMapTableModel  ccrToFcrModel; 

/** 

*  Event  listener  list. 

*/ 

EventListenerList  _listeners  =  new  EventListenerList ( ) ; 

/** 

*  Array  of  mappings  of  FCR  to  CCR  attributes, 

*  this  array  should  only  be  valid  after  the  skeleton  code  is  generated. 
*/ 

AttributeMapping [ ]  _f crToCcrMapping; 

/** 

*  Array  of  mappings  of  CCR  to  FCR  attributes, 

*  this  array  should  only  be  valid  after  the  skeleton  code  is  generated. 
*/ 

AttributeMapping [ ]  _ccrToFcrMapping; 


JPanel  contentPane; 

JButton  f crToCcrButton  =  new  JButtonO; 

JButton  ccrToFcrButton  =  new  JButtonO; 

// JScrollPane  jScrollPanel  =  new  JScrollPane ( ) ; 

//JTable  leftTable  =  new  JTableO; 

//JScrollPane  jScrollPane2  =  new  JScrollPane () ; 

//JTable  rightTable  =  new  JTableO; 

JScrollPane  f crToCcrTableScrollPane  =  new  JScrollPane () ; 
JTable  f crToCcrTable  =  new  JTableO; 
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JScrollPane  ccrToFcrTableScrollPane  =  new  JScrollPane ( ) ; 

JTable  ccrToFcrTable  =  new  JTableO; 

JButton  removeLeftToRightButton  =  new  JButtonO; 

JButton  removeRightToLef tButton  =  new  JButtonO; 

JButton  generateButton  =  new  JButtonO; 

JScrollPane  f crTreeScrollPane  =  new  JScrollPane () ; 

JTree  fcrTree  =  new  JTree () ; 

JScrollPane  ccrTreeScrollPane  =  new  JScrollPane () ; 

JTree  ccrTree  =  new  JTree () ; 

public  Plugin (  Container  container,  FCR  fcr,  CCR  ccr.  String  packageNamePref ix 
throws  mil . navy . nps . cs . oomi . exceptions . IntrospectionException 
ClassNotFoundException  { 

uilnit (container) ; 

init (fcr,  ccr,  packageNamePref ix) ; 

} 


private  void  init (FCR  fcr,  CCR  ccr.  String  packageNamePref ix) 

throws  mil . navy . nps . cs . oomi . exceptions . IntrospectionException 
ClassNotFoundException  { 

_fcr  =  fcr; 

_fiom  =  _f cr . getFEV () . getFE () . getFIOM () ; 

_ccr  =  ccr; 

_packageNamePref ix  =  packageNamePref ix; 
fcrClass  =  Class . forName (fcr . get JavaClassName ()) ; 
ccrClass  =  Class . forName (ccr . get JavaClassName ()) ; 
fcrToCcr  =  new  TranslationMap (fcrClass . getName () , 

ccrClass . getName () ) ; 

ccrToFcr  =  new  TranslationMap (ccrClass . getName () , 

fcrClass . getName () )  ; 

f crToCcrModel  =  new  TranslationMapTableModel (fcrToCcr)  ; 
ccrToFcrModel  =  new  TranslationMapTableModel (ccrToFcr) ; 

fcrTree . setModel (  new  AttributesTreeModel (  fcrClass  )); 
ccrTree . setModel (  new  AttributesTreeModel (  ccrClass  )); 


f crToCcrTable . setModel (fcrToCcrModel)  ; 
ccrToFcrTable . setModel (ccrToFcrModel )  ; 


public  Container  getContentPane ( )  { 

return  contentPane; 
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/* 

void  uilnit (Container  container)  { 

//set Iconlmage (Toolkit . getDef aultToolkit ( ) . createlmage (DemoGeneratorAppMainFrame . class . getReso 
urce  ( " [Your  Icon] " ) ) ) ; 

contentPane  =  (JPanel)  container; 

contentPane . setLayout (null) ; 

//this . setSize (new  Dimension ( 683,  554)); 

//this . set Title ( "Frame  Title" ) ; 

f crToCcrButton . setToolTipText ( " " )  ; 

f crToCcrButton . setText ( " — >" )  ; 

f crToCcrButton . setBounds (new  Rectangle (332,  68,  56,  27)); 
f crToCcrButton . addAct ionListener (new  java . awt . event . ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
f crToCcrButton_actionPerf ormed (e) ; 


})  ; 

ccrToFcrButton . setBounds (new  Rectangle (331,  125,  56,  27)); 
ccrToFcrButton . addAct ionListener (new  java . awt . event .ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
ccrToFcrButton_actionPerf ormed (e) ; 


})  ; 

ccrToFcrButton . setText ( "< — " )  ; 
ccrToFcrButton . setToolTipText ( " " )  ; 

// jScrollPanel . setBounds (new  Rectangle (8,  18,  307,  15)); 

// jScrollPane2 . setBounds (new  Rectangle (394,  18,  147,  18)); 

/ / rightTable . setBorder (BorderFactory . createEtchedBorder ( ) ) ; 
f crToCcrTableScrollPane . setBounds (new  Rectangle (7,  259,  621,  102)); 
f crToCcrTable . setBorder (BorderFactory . createEtchedBorder ( ) ) ; 
ccrToFcrTableScrollPane . setBounds (new  Rectangle (7,  370,  622,  126)); 
ccrToFcrTable . setBorder (BorderFactory . createEtchedBorder ( ) )  ; 
removeLeftToRightButton . setFont (new  java . awt . Font ( "Dialog" ,  1,  12)); 
removeLef tToRightButton . setText ( "X" )  ; 

removeLeftToRightButton . setBounds (new  Rectangle ( 633,  297,  43,  27)); 
removeLeftToRightButton . addAct ionListener (new  java . awt . event . ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
removeLeftToRightButton_actionPerf ormed (e)  ; 


}); 

removeRightToLeftButton . setFont (new  java . awt . Font ( "Dialog" ,  1,  12)); 
removeRightToLef tButton . setText ( "X" ) ; 
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removeRightToLef tButton . setBounds (new  Rectangle ( 635,  420,  43,  27)); 
removeRightToLef t But ton . addActionListener (new  java . awt . event . ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
removeRightToLeftButton_actionPerf ormed (e) ; 


})  ; 

generateButton . setText ( "Generate  Skeleton" ) ; 
generateButton . setBounds (new  Rectangle ( 1 67 ,  505,  208,  27)); 
generateButton . addActionListener (new  java . awt . event . ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
generateButton_act ionPerf ormed (e) ; 


}); 

f crTreeScrollPane . setBounds (new  Rectangle (9,  57,  318,  187)); 

ccrTreeScrollPane . setBounds (new  Rectangle (392,  56,  282,  188)); 

contentPane . add (f crToCcrTableScrollPane,  null) ; 

contentPane . add (ccrToFcrTableScrollPane,  null) ; 

contentPane . add (removeLeftToRightButton,  null) ; 

contentPane . add (removeRightToLeftButton,  null) ; 

//contentPane . add ( jScrollPanel,  null) ; 
contentPane . add (ccrToFcrButton,  null)  ; 
contentPane . add (f crToCcrButton,  null) ; 

//contentPane . add ( jScrollPane2,  null) ; 
contentPane . add (generateButton,  null)  ; 
contentPane . add ( f crTreeScrollPane,  null) ; 
contentPane . add (ccrTreeScrollPane,  null) ; 
ccrTreeScrollPane . getViewport ( ) . add (ccrTree,  null); 
f crTreeScrollPane . getViewport ( ) . add (fcrTree,  null); 

// jScrollPane2 . getViewport ( ) . add (rightTable,  null); 
//jScrollPanel . getViewport ( ) . add ( left Table,  null) ; 
ccrToFcrTableScrollPane . getViewport () . add (ccrToFcrTable,  null) ; 
f crToCcrTableScrollPane . getViewport () . add (fcrToCcrTable,  null) ; 


*/ 

void  uilnit (Container  container)  { 

//set Iconlmage (Toolkit . getDef aultToolkit ( ) . createlmage (DemoGeneratorAppMainFrame . class . getReso 
urce  (" [Your  Icon] ") ) ) ; 

if  (container==null) 

contentPane  =  new  JPanelO; 

else 

contentPane  =  (JPanel)  container; 

contentPane . setLayout (new  GridBagLayout ( ) ) ; 
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GridBagConstraints  c  =  new  GridBagConstraints ( ) ; 

/* 

this . set Size (new  Dimension ( 683,  554)); 
this . setTitle ( "Frame  Title"); 

*/ 

f crToCcrButton . setToolTipText ( " " )  ; 
f crToCcrButton . setText ( " — >"  )  ; 

//f crToCcrButton . setBounds (new  Rectangle (332,  68,  56,  27)); 
f crToCcrButton . addAct ionListener (new  java . awt . event . ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
f crToCcrButton_actionPerf ormed (e) ; 


}); 

//ccrToFcrButton . setBounds (new  Rectangle (331,  125,  56,  27)); 
ccrToFcrButton . addAct ionListener (new  java . awt . event . ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
ccrToFcrButton_act ionPerf ormed (e) ; 


})  ; 

ccrToFcrButton . setText ( "< — " )  ; 
ccrToFcrButton . setToolTipText ( " " )  ; 

//f crToCcrTableScrollPane . setBounds (new  Rectangle (7,  259,  621,  102)); 
f crToCcrTable . setBorder (BorderFactory . createEtchedBorder ( ) ) ; 
//ccrToFcrTableScrollPane . setBounds (new  Rectangle (7,  370,  622,  126)); 
ccrToFcrTable . setBorder (BorderFactory . createEtchedBorder ( ) )  ; 
removeLeftToRightButton . setFont (new  java . awt . Font ( "Dialog" ,  1,  12)); 
removeLef tToRightButton . setText ( "X" )  ; 

//removeLeftToRightButton . setBounds (new  Rectangle ( 633,  297,  43,  27)); 
removeLeftToRightButton . addActionListener (new  java . awt . event .ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
removeLeftToRightButton_actionPerf ormed (e) ; 


}); 

removeRightToLeftButton . setFont (new  java . awt . Font ( "Dialog" ,  1,  12)); 
removeRightToLef tButton . setText ( "X" ) ; 

//removeRightToLef tButton . setBounds (new  Rectangle ( 635,  420,  43,  27)); 
removeRightToLeftButton . addActionListener (new  java . awt . event . ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
removeRightToLeftButton_actionPerf ormed (e) ; 


})  ; 

generateButton . setText ( "Generate  Skeleton" ) ; 

//generateButton . setBounds (new  Rectangle ( 1 67 ,  505,  208,  27)); 
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gene rat eBut ton . addAct ionListener (new  java . awt . event . ActionListener ( )  { 

public  void  actionPerf ormed (ActionEvent  e)  { 
generateButton_act ionPerf ormed (e) ; 

} 

}); 

//f crTreeScrollPane . setBounds (new  Rectangle (9,  57,  318,  187)); 
//ccrTreeScrollPane . setBounds (new  Rectangle (392,  56,  282,  188)); 

c.fill  =  GridBagConstraints . BOTH; 

c.weightx  =  1.0; 

c. weighty  =  1.0; 

c.gridwidth  =  13; //4; 

c.gridheight  =  13; //5; 

c.gridx  =  l;//0; 

c.gridy  =  l;//0; 

contentPane . add ( f crTreeScrollPane,  c)  ; 

c.weightx  =  0.0; 
c. weighty  =  0.0; 
c.gridwidth  =  2;//l; 
c.gridheight  =  2;//l; 
c.gridx  =  15; / / 5 ; 
c.gridy  =  2;//l; 

contentPane . add (ccrToFcrButton,  c)  ; 

c.fill  =  GridBagConstraints . HORIZONTAL; 
c.gridx  =  15; / / 5 ; 
c.gridy  =  6;//4; 

contentPane . add (f crToCcrButton,  c)  ; 

c.fill  =  GridBagConstraints . BOTH; 

c.weightx  =  1.0; 

c. weighty  =  1.0; 

c.gridwidth  =  13; / / 4 ; 

c.gridheight  =  13; //5; 

c.gridx  =  19;// 6; 

c.gridy  =  l;//0; 

contentPane . add (ccrTreeScrollPane,  c)  ; 

c.weightx  =  1.0; 
c. weighty  =  1.0; 
c.gridwidth  =  22; / / 8 ; 
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c.gridheight  =  6;//4; 
c.gridx  =  l;//0; 
c.gridy  =  16;// 6; 

contentPane . add (f crToCcrTableScrollPane,  c)  ; 

c.weightx  =  0.0; 
c. weighty  =  0.0; 
c.gridwidth  =  2;//l; 
c.gridheight  =  2;//l; 
c.gridx  =  24; //10; 
c.gridy  =  16;// 6; 

contentPane . add (removeLeftToRightButton,  c)  ; 

c.weightx  =  1.0; 
c. weighty  =  1.0; 
c.gridwidth  =  22;//8; 
c.gridheight  =  6;//4; 
c.gridx  =  l;//5; 
c.gridy  =  23;//12; 

contentPane . add (ccrToFcrTableScrollPane,  c) ; 

c.weightx  =  0.0; 
c. weighty  =  0.0; 
c.gridwidth  =  2;//l; 
c.gridheight  =  2;//l; 
c.gridx  =  24; //10; 
c.gridy  =  23;//12; 

contentPane . add (removeRightToLeftButton,  c)  ; 

c.weightx  =  1.0; 
c.gridwidth  =  10; 
c.gridheight  =  2;//l; 
c.gridx  =  13; //5; 
c.gridy  =  30; //l; 

c. insets  =  new  Insets (  2,  10,  2,  10  )  ; 
contentPane . add (generateButton,  c)  ; 

ccrTreeScrollPane . getViewport ( ) . add (ccrTree,  null); 
f crTreeScrollPane . getViewport ( ) . add (fcrTree,  null); 

ccrToFcrTableScrollPane . getViewport () . add (ccrToFcrTable, 
f crToCcrTableScrollPane . getViewport () . add (fcrToCcrTable, 


null) 

null) 
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void  f crToCcrButton_actionPerf ormed (ActionEvent  e)  { 
addMapping (  fcrTree,  ccrTree,  f crToCcrTable  ); 

} 


void  ccrToFcrButton_act ionPerf ormed (ActionEvent  e)  { 
addMapping (  ccrTree,  fcrTree,  ccrToFcrTable  ); 

} 

void  addMapping (  JTree  src,  JTree  dst,  JTable  mapTable  )  { 

TranslationAttribute [ ]  selectedAttrs  =  AttributesTreeModel . selectedAttributes (src) 
// Trans lationAt tribute . d (selectedAttrs)  ; 

Translat ionAttributeMapping  mapping  =  new  TranslationAttributeMapping ( 

selectedAttrs, 

AttributesTreeModel . selectedAttributes (dst ) [ 0 ] ) ; 
TranslationMapTableModel  mapModel  =  (TranslationMapTableModel )  mapTable . getModel ( ) 
mapModel . add (mapping) ; 


void  removeLef tToRightButton_actionPerf ormed (ActionEvent  e)  { 
removeMappings (f crToCcrTable)  ; 

} 

void  removeRightToLef tButton_actionPerf ormed (ActionEvent  e)  { 
removeMappings (ccrToFcrTable)  ; 

} 

void  removeMappings (  JTable  mappingsTable  )  { 

TranslationMapTableModel  model= (TranslationMapTableModel ) mappingsTable . getModel ( ) ; 
int [ ]  rows  =  mappingsTable . getSelectedRows ()  ; 
model . remove ( rows )  ; 

} 


void  generateButton_actionPerf ormed (ActionEvent  e)  { 

StringBuffer  sb  =  new  StringBuf f er ( 1024 ) ; 

StringBuf f erOutput Stream  out  =  new  StringBuf ferOutputStream (sb) ; 

JavaFileDef init ion  fileDef  =  generateSkeletion (out ) ; 

f ireCodeGeneration (  fileDef . getPackageName ( ) , 

fileDef . getPublicClass ( ) . getName ( ) , 

sb . toString ( ) , 

fileDef . targetFile ( )  ); 


public  void  addCodeGenerationListener (  CodeGenerationListener  listener  )  { 

_listeners . add (  CodeGenerationListener . class,  listener  ); 
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} 

public  void  removeCodeGenerationListener (  CodeGenerationListener  listener  )  { 

_listeners . remove (  CodeGenerationListener . class,  listener  ); 

} 

protected  void  f ireCodeGeneration (  String  packageName, 

String  className, 

String  generatedCode, 

File  javaFile  )  { 

//  Guaranteed  to  return  a  non-null  array 

Object []  listeners  =  _listeners . getListenerList ( ) ; 

//  Process  the  listeners  last  to  first,  notifying 
//  those  that  are  interested  in  this  event 
for  (int  i  =  listeners . length-2 ;  i>=0;  i-=2)  { 

EventObject  event  =  null; 

if  (listeners [i] ==CodeGenerationListener . class)  { 

//  Lazily  create  the  event: 
if  (event  ==  null) 

event  =  new  CodeGeneratedEvent (this,  packageName, 

className,  generatedCode, 
javaFile  ) ; 

( (CodeGenerationListener) listeners [i+1] ) . codeGenerated ( (CodeGeneratedEvent) 

event) ; 

} 

} 

} 


/** 

*  Generates  the  translation  skeleton  and  writes  it  to  the  specified 

*  OutputStream, 

*  updates  the  fields  _ccr,  _f crToCcrMapping  and  _ccrToFcrMapping . 

*  Upon  successful  completion  of  this  method, 

*  the  following  tasks  are  completed: 

*  <ol> 

*  <li>  Writing  the  translation  skeleton  to  the  specified  OutputStream. 

*  <li>  Updating  the  FCR  to  CCR  attribute  mapping  information  contained 

*  in  the  _ccr  field  of  this  object. 

*  <li>  Updating  the  _f crToCcrMapping  field  of  this  object. 

*  <li>  Updating  the  _ccrToFcrMapping  field  of  this  object. 

*  </ ol> 

*  @param  out  The  translation  skeleton  will  be  written  to  the  OutputStream 

*  referenced  by  this  parameter. 

*  ©return  Returns  the  JavaFileDef inition  object  used  to  generate  the 
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skeleton . 


JavaFileDef inition  generateSkeletion (  OutputStream  out  )  { 

//  clear  the  existing  mappings 

_ccr . clearFCRToCCRAttributeMappings () ; 

JavaFileDef inition  fileDef  = 

Trans lationFactory . newFiomTranslationFile ( 

_packageNamePref ix, 
f crClass . getName ( ) , 
ccrClass . getName ( ) 

) ; 

Trans lationClassDef inition  classDef 

=  (TranslationClassDef inition) fileDef . getPublicClass () ; 
int  count  =  f crToCcr . getCount ( ) ; 

_f crToCcrMapping  =  new  AttributeMapping [count ] ; 
for  (int  i=0;  i<count;  i++)  { 

classDef . addMethod ( 

TranslationFactory . newFcrToCcrMethod (fcrToCcr . get (i) )  )  ; 

_f crToCcrMapping [ i ]  =  toAttributeMapping (fcrToCcr . get (i) ) ; 

__ccr . addFCRToCCRAttributeMapping (  _f crToCcrMapping [ i ] . f romAttributes ( 

_f crToCcrMapping [ i ] . toAttribute ( )  ) 
//p(  _f crToCcrMapping [i] . toString ( )  ); 

} 

count  =  ccrToFcr . getCount ()  ; 

_ccrToFcrMapping  =  new  AttributeMapping [count ] ; 
for  (int  i=0;  i<count;  i++)  { 

classDef . addMethod ( 

TranslationFactory . newCcrToFcrMethod (ccrToFcr . get (i) )  )  ; 

_ccrToFcrMapping [ i ]  =  toAttributeMapping (ccrToFcr . get (i) )  ; 

/ /p (  _ccrToFcrMapping [i] .toString ()  ); 

} 

classDef . generateAbstractOverrides ()  ; 

Translat ionGenerator  generator  =  new  TranslationGenerator ( ) ; 
generator . generate (out,  fileDef) ; 
return  fileDef; 


/** 

*  Creates  a  AttributeMapping  object,  based  on  the  specified 

*  TranslationAttributeMapping  object. 

*  @param  transMapping 

*  ©return  Returns  a  new  AttributeMapping  object  that  reflects  the 
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information  captured  in  the  specified  TranslationAttributeMapping  object. 


*/ 


AttributeMapping  toAttributeMapping  (  TranslationAttributeMapping  mapping  )  { 

AttributeMapping  result 

=  _f iom . factory ( ) . makeAttributeMapping ( 

toAttributeArray (mapping . getSourceAttributes ( ) ) , 

toAttribute (mapping . getTargetAttribute ( ) ) )  ; 

return  result; 


/** 

*  Creates  an  array  of  Attribute  objects  representing  the 

*  path  information  of  each  element  of  the  specified  array  of 

*  TranslationAttribute  objects. 

*  @param  transAttr 

*  @return  Returns  the  array  created. 

*/ 

Attribute []  toAttributeArray (  TranslationAttribute [ ]  transAttrs  )  { 

Attribute []  result  =  new  Attribute [transAttrs . length] ; 
for  (int  i=0;  ictransAttrs . length;  i++)  { 

result [i]  =  toAttribute (  transAttrs [ i ]  ); 

} 

return  result; 


/** 

*  Create  an  Attribute  object  that  represents  the  path  information  contained 

*  in  the  specified  TranslationAttribute  object. 

*  The  root  translation  attribute  is  not  included,  since  it  represents  the 

*  actual  class. 

*  @param  transAttr 

*  ©return  Returns  the  Attribute  object  created. 

*/ 

Attribute  toAttribute (  TranslationAttribute  transAttr  )  { 

FIOMFactory  f  =  _f iom. factory () ; 

TranslationAttribute [ ]  path  =  transAttr .pathToArray () ; 

Attribute  parent  =  null; 

Attribute  curr  =  null; 

//  start  from  1,  to  skip  the  root  attribute 
for  (int  i=l;  i<  path. length;  i++)  { 

curr  =  f .makeAttribute (  parent,  path [i] . getName ( ) , 

f . makeTypeName (path [ i ] . getType ( ) )  ) ; 

parent  =  curr; 


return  curr; 
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}  //  Plugin 


public  static  void  p (String  m)  { 
System. out . print In (m) ; 

} 


class  StringBuf ferOutputStream  extends  OutputStream  { 
StringBuffer  _sb  =  null; 

/** 


*/ 

public  StringBuf ferOutputStream  (StringBuffer  sb)  { 
_sb  =  sb; 

} 

public  void  write  (int  b)  { 

StringWriter  writer  =  new  StringWriter ( 10 ) ; 
writer. write (b) ; 

_sb . append (writer . getBuf f er ( ) . toString ( ) ) ; 

} 

public  void  close ()  throws  IOException  { 

_sb  =  null; 
super . close  ( ) ; 


5.  JavaFileDefinition.java 

package  mil . navy . nps . cs . oomi . translator; 

import  java. util.*; 
import  java . io . File; 

/** 

*  Defines  a  Java  source  file. 

*  Currently,  supports  only  one  class,  the  only  public  class  allowed  in  a 

*  Java  file. 

*  ©author  LSC 

*  ©version  1.0 
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/ 


public  class  JavaFileDef inition  { 

/** 

*  Package  name  for  this  ClassDef inition . 

*  This  is  optional. 

*/ 

protected  String  _packageName  =  null; 

/** 

*  List  of  imports  for  this  class. 

*  The  entries  are  strings  less  the  keyword  "import". 

*/ 

protected  List  _imports  =  new  ArrayList (10) ; 

/** 

*  Custom  code  segment  for  import  statements  managed  by  the  user. 
*/ 

protected  List  _userManagedImports  =  new  LinkedList ( ) ; 

/** 

*  The  public  class  in  this  Java  source  file. 

*/ 

protected  ClassDef inition  _publicClass  =  null; 

public  JavaFileDef inition (  ClassDef inition  publicClass  )  { 

setPublicClass (publicClass) ; 

} 


public  void  setPackageName (String  packageName)  { 
this ._packageName  =  packageName; 

} 

public  String  getPackageName ( )  { 

return  this ._packageName; 


/** 

*  @param  imports  List  of  strings  that  specifies  the  import  statements, 

*  the  strings  should  not  include  the  keyword  "import". 


*/ 

public  void  addlmports (  List  imports  )  { 

this  . __import s  .  addAll  ( imports )  ; 
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public  String []  importsToArray ( )  { 

int  size  =  this . _imports . size  () ; 
if  (size>0) 

return  (String [])  this ._imports . toArray (new  String [ size] ) ; 
else 

return  null; 

} 

public  String []  userManagedlmportsToArray ( )  { 

if  (this ._userManagedImport s . size ( ) >0 ) 

return  (String [])  this ._userManagedImports . toArray () ; 
else 

return  null; 


public  void  setPublicClass (  ClassDef inition  publicClass  )  { 

this ._publicClass  =  publicClass; 

} 

public  ClassDef inition  getPublicClass ( )  { 

return  this ._publicClass; 


/** 

*  Returns  the  relative  path  that  this  object's  corresponding  Java  source 

*  file  should  be  located. 

*  For  example,  for  a  JavaFileDef inition  with  main  class  "pi .p2 . ClassA" , 

*  the  relative  path  will  be  "pl/p2/ClassA. java" . 

*/ 

public  File  targetFileO  { 

String  className  =  getPublicClass  ().  getName  ()  ; 

String  path  =  StringHelper . replaceAll ( 

getPackageName () , 

".",  File . separator ) ; 

return  new  File (path,  className  +  ".java"); 

} 


6.  MethodDefinition.java 

package  mil . navy . nps . cs . oomi . translator; 
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import  java. util.*; 


/** 

*  <p> 

*  An  instance  of  this  class  defines  the  source  code  of  a  method 

*  of  a  Java  class. 

*  <p> 

*  The  assumption  made  is  that  field  values  can  only  be  accessed  through 

*  the  accessor/modifier  methods  of  the  classes  involved. 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  class  MethodDef inition  { 

/** 

*  Name  of  this  method. 

*/ 

protected  String  _name  =  null; 

/** 

*  The  string  specifying  the  modifiers  of  this  method, 

*  for  example,  "public  static" . 

*/ 

protected  String  _modifiers  =  null; 

/** 

*  List  of  the  method's  formal  parameters  (type  and  name  of  each  parameter) . 
*/ 

protected  List  _params  =  new  ArrayList (2 ) ; 

//  assume  an  average  of  2  parameters  per  method 


/** 

*  Source  code  of  the  method's  body. 


*/ 

protected  List  _bodyLines  =  new  LinkedList ( ) ; 

/** 

*  Return  type  of  this  method. 

*/ 
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protected  String  _returnType  =  null; 


public  MethodDef inition ( )  { 

} 

public  MethodDef inition ( String  modifiers. 

String  returnType, 
String  methodName)  { 
this . setModif iers (modifiers) ; 
this . setReturnType (returnType)  ; 
this . setName (methodName) ; 


/** 

*  Adds  a  parameter  for  this  method. 

*/ 

public  void  addParam (String  type.  String  name)  { 

this ._params . add (  new  MethodParameter (type, name)  ); 


/** 

*  Adds  parameters  for  this  method. 
*/ 


public  void  addParams (MethodParameter [ ]  params)  { 
for  (int  i=0;  i<params . length;  i++)  { 

//  Uses  the  same  copy  so  as  to  maintain  additional  information 
//  if  the  actual  objects  are  descendents,  like  Attribute, 
this ._params . add (  params [i]  ); 


public  void  setName (String  methodName)  { 
this._name  =  methodName; 

} 

public  String  getNameO  { 
return  this._name; 

} 

public  void  setModifiers (String  methodModif iers)  { 
this ._modif iers  =  methodModif iers; 

} 

public  String  getModif iers ( )  { 

return  this ._modif iers; 

} 

public  void  setBody (  List  bodyLines  )  { 

this ._bodyLines . clear ( )  ; 
this ._bodyLines . addAll (bodyLines)  ; 
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} 

public  void  setBody(  String  body  )  ( 

this ._bodyLines . clear ( )  ; 
this ._bodyLines . add (body)  ; 

} 

public  String!]  bodyLinesToArray ( )  ( 

if  (this ._bodyLines . isEmpty ( ) )  ( 

return  null; 

} 

else 

return  (String]]) 

(this ._bodyLines . toArray (new  String [this ._bodyLines . size ()])); 

} 

public  MethodParameter [ ]  paramsToArray ( )  { 

if  (this ._params . isEmpty () )  ( 

return  null; 

) 

else 

return  (MethodParameter]]) 

(this ._params . toArray (new  MethodParameter [this ._params . size ( ) ] ) ) 

} 

public  void  setReturnType (  String  returnType  )  { 

this -_returnType  =  returnType; 

} 

public  String  getReturnType ( )  ( 

return  this ._returnType; 


7.  MethodParameter  .java 

package  mil. navy . nps . cs . oomi . translator ; 


/** 

*  @author  LSC 

*  (Aversion  1.0 
*/ 

public  class  MethodParameter  ] 

/** 
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Parameter  name. 


*/ 

protected  String  _name  =  null; 

/** 

*  Parameter  type. 

*/ 

protected  String  _type  =  null; 

/** 

*  The  class  type  of  this  attribute. 

*  This  is  optional,  used  only  if  paramType  is  not 

*  set  in  the  constructor. 

V 

protected  Class  _typeAsClass  =  null; 

/** 

*  No-argument  constructor,  generally  not  used. 

*/ 

protected  MethodParameter ( )  { 

//  do  nothing 


/** 

*  Creates  an  instance  of  MethodParameter  with  given  name  and  type. 
*/ 

public  MethodParameter (  String  paramType,  String  paramName  )  ( 

setType (paramType) ; 
setName (paramName)  ; 


/** 

*  Creates  an  instance  of  MethodParameter  with  the  given  class. 
*/ 

public  MethodParameter (  Class  paramType,  String  paramName  )  ( 

setTypeAsClass (paramType)  ; 
setName (paramName)  ; 


/** 

*  Method  is  named  setParamClass ( )  to  avoid  conflict  with  Ob ject . getClass ( ) . 
*/ 

private  void  setTypeAsClass (  Class  val  )  { 

_typeAsClass  =  val; 

} 

private  void  setName  (String  name)  { 
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.name 


name ; 


/** 

*  Converts  the  specified  type  into  the  internal  format,  if  it  is 

*  not  already  in  the  format . 


*/ 

private  void  setType  (String  type)  ( 

_type  =  Ref lectionHelper . toRuntimeTypeName (type) ; 


/** 

*  Returns  the  name  of  this  parameter,  with  the  fully  qualified  type  name 

*  converted  to  the  source  code  format. 

*/ 

public  String  getNameO  { 
return  _name  ; 

} 

public  Class  getTypeAsClass ( )  ( 

return  _typeAsClass ; 

} 

public  String  getTypeO  ( 
if  (getTypeAsClass ()! =null) 

return  typeAsSourceCode (getTypeAsClass () .getName () ) ; 
else 

return  typeAsSourceCode (_type)  ; 

) 

public  String  toStringO  { 

return  getTypeO  +  "  "  +  getNameO; 


/** 

*  A  MethodParameter  is  decomposable  only  if  the  typeAsClass  property  is  set. 
*/ 

public  boolean  isDecomposable ( )  ( 

return  getTypeAsClass ()! =null; 


/** 

*  Equals  if  name  and  type  matches . 

*/ 

public  boolean  equals (Object  obj)  { 
if  (obj==null) 
return  false; 

else  if  (  !  this . getClass (). islnstance (obj )  ) 
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return  false; 
else  { 

MethodParameter  o  =  (MethodParameter) ob j ; 
return  (this . getName (). equals (o . getName () )  && 


*  Converts  the  type  into  source  code  format. 

*/ 

public  static  String  typeAsSourceCode (String  qualif iedTypeName)  { 
if  (qualif iedTypeName . indexOf ('[')! =-l )  { 

StringBuffer  result  =  new  StringBuf f er ( ) ; 

String  className  =  qualif iedTypeName; 

int  len  =  className . length ()  ; 

int  i  =  0; 

while  (className . charAt (i) =='[' )  { 

result . append ("[]"); 
i++; 

} 

String  type; 

switch  (className . charAt (i) )  { 

case  'B':  type  =  byte . class . getName () ;  break; 
case  '  C':  type  =  char . class . getName () ;  break; 
case  ' D':  type  =  double . class . getName () ;  break; 
case  ' F':  type  =  float . class . getName () ;  break; 
case  ' I ' :  type  =  int . class . getName () ;  break; 
case  'J':  type  =  long . class . getName () ;  break; 
case  'S':  type  =  short . class . getName () ;  break; 
case  '  Z':  type  =  boolean . class . getName () ;  break; 
case  'L':  type  =  className . substring (i+1 , len-1 ) ;  break; 
default : 
type  = 

} 

result . insert  ( 0 ,  type); 

return  result . toString  () ; 

} 

else 

return  qualif iedTypeName; 
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8.  ReflectionHelper.java 


package  mil . navy . nps . cs . oomi . translator; 

/** 

*  @author  LSC 

*  ^version  1 . 0 
*/ 

public  class  Ref lectionHelper  extends  Exception  { 

protected  Ref lectionHelper ( )  { 

} 


*  Converts  the  specified  type  name  to  the  internal  format  that  should 

*  be  returned  from  Class . getName () . 

*  Arrays  are  converted  accordingly,  for  example, 

*  "int[]"  is  converted  to  "[I", 

*  "String [][] "  is  converted  to  " [ [LString; " . 

*/ 

public  static  String  toRuntimeTypeName (  String  typeName  )  { 

if  (isArray (typeName) )  { 

if  (typeName . indexOf ('[') ==0) 

return  typeName;  //  already  in  correct  format 
int  dimCount  =  countDimensions (typeName) ; 

StringBuffer  type  =  new  StringBuffer (typeName) ; 

StringHelper . replaceAll (  type,  "[",  ""  ); 

StringHelper . replaceAll (  type,  "]",  ""  ); 

//type  =  "int"; 

/ / return  String . valueOf (type . toString ( ) . equals ( " int" ) ) ; 

//return  "-"  +  type  + 

return  encodeToArraySignature (  type . toString () ,  dimCount  ); 


else 

return 

} 


typeName; 


/** 

*  Counts  the  number  of  dimension  of  the  specified  typeName,  by  counting  the 

*  number  of  ' ['  in  the  string. 

*  If  non-array,  returns  0,  that  is,  zero  dimensions. 

*  typeName  can  be  of  either  internal  (that  is,  runtime)  form  or 
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*  the  form  in  source  code,  for  example,  " int  [  ] "  or  "[I;". 

*  @param  typeName  The  type  name  whose  number  of  dimensions  is  to  be 

*  determined. 

*  ©return  Returns  the  number  of  dimensions  of  the  specified  type. 

*/ 

public  static  int  countDimensions (  String  typeName  )  { 

return  StringHelper . count (  typeName,  ' ['  ); 

} 


/** 

*  Determines  if  the  given  type  name  is  an  array. 

*  ©return  True  if  and  only  if  typeName  contains  at  least  one  * [ ' . 
*/ 

public  static  boolean  isArray (String  typeName)  { 
return  typeName . indexOf ('[')! =-l ; 

} 


/** 

*  Encodes  the  specified  type  name  (non-array  type) 

*  into  its  qualified  type  name 

*  as  an  array. 

*  ©param  qualif iedTypeName  The  non-array  qualified  type  name  to  be  the 

*  element  type  of  the  array. 

*  ©param  dimCount  The  number  of  dimensions  the  array  should  have. 

*  ©return  The  internal  Java  signature  of  array. 

*/ 

public  static  String  encodeToArraySignature (String  qualif iedTypeName, 

int  dimCount)  { 

String  result; 

if  (qualif iedTypeName . equals (byte . class . getName ( ) ) ) 
result  =  "B"; 

else  if  (qualif iedTypeName . equals (char . class . getName ()) ) 
result  =  "C"; 

else  if  (qualif iedTypeName . equals (double . class . getName ()) ) 
result  =  "D"; 

else  if  (qualif iedTypeName . equals (float . class . getName ()) ) 
result  =  "F"; 

else  if  (qualif iedTypeName . equals (int . class . getName ()) ) 
result  =  "I"; 

else  if  (qualif iedTypeName . equals ( long . class . getName ()) ) 
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result 


=  "J"; 

else  if  (qualif iedTypeName . equals (short . class . getName  ()) ) 
result  =  "S"; 

else  if  (qualif iedTypeName . equals (boolean . class . getName ()) ) 
result  =  "Z"; 
else 

result  =  "L"  +  qualif iedTypeName  + 
return  StringHelper . repeat ("[" ,  dimCount)  +  result; 


9.  StringHelper.java 

package  mil. navy . nps . cs . oomi . translator ; 

/** 

*  @author  LSC 

*  ©version  1 . 0 

V 

public  class  StringHelper  { 

/** 

*  String  of  whitespace  characters. 

*/ 

public  static  final  String  WHITE_SPACE  =  "  \t"; 

/** 

*  Non-instantiable  class  with  protected  constructor. 
*/ 

protected  StringHelper ( )  { 

} 


/** 

*  Returns  the  index  of  the  first  occurence  of  <code>  substr  </code>  within 

*  <code>  str  </code>. 

*  ©returns  -1  if  <code>  substr  </code> 

*  does  not  exist  within  <code>  str  </code> 

*/ 

public  static  int  indexOf {  StringBuf fer  str.  String  substr,  int  beginlndex  )  { 

return  str . toString (). indexOf ( substr ,  beginlndex); 

} 
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/ 


*  Replaces  all  occurence  of  oldString  with  newString  within  theString. 
*/ 

public  static  void  replaceAll (  StringBuffer  theString, 

String  oldString,  String  newString  )  { 

if  (oldString . length ()! =0  )  { 

int  i=0 ; 

int  inc  =  newString . length  () ; 
int  start  =  0; 

int  offsetToEnd  =  oldString . length () ; 
while  (ictheString. length () )  { 

start  =  indexOf (theString,  oldString,  i  ) ; 
if  (start !=-l)  { 

theString. replace (start,  start+of f setToEnd,  newString); 

//  start  next  scan  from  end  of  replacement 
i  =  start+inc; 

} 

else  { 
break  ; 


/** 

*  Replaces  all  occurence  of  oldString  with  newString  within  theString. 

*  A  convenience  method  that  uses  String  instead  of  the  more  efficient 

*  StringBuffer. 

*/ 

public  static  String  replaceAll (  String  theString, 

String  oldString,  String  newString  )  { 

StringBuffer  buffer  =  new  StringBuffer (theString) ; 
replaceAll (buffer, oldString,  newString)  ; 
return  buf f er . toString ( ) ; 


/** 

*  Returns  a  string  with  <code>character</code> 

*  repeated  <code>count</code>  times. 

*/ 

public  static  String  repeat (  char  character,  int  count  )  { 

StringBuffer  result  =  new  StringBuffer (count ) ; 
for  (int  i=0;  iccount;  i++)  { 

result . append (character) ; 

} 
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return  result . toString () ; 


/** 

*  Returns  a  string  with  <code>str</code> 

*  repeated  <code>count</code>  times. 

*/ 

public  static  String  repeat (  String  str,  int  count  )  { 

StringBuffer  result  =  new  StringBuffer (count ) ; 
for  (int  i=0;  i<count;  i++)  { 

result . append (str) ; 

} 

return  result . toString  ( ) ; 


/** 

*  Counts  the  number  of  occurence  of  the  specified  character  in  the 

*  specified  string. 

*/ 

public  static  int  count (  String  str,  char  c  )  { 

int  len  =  str . length () ; 
int  result  =  0; 
for  (int  i=0;  iclen;  i++)  { 

if  (str . charAt (i) ==c) 
result  ++; 

} 

return  result; 


/** 

*  Concatenates  the  given  Objects  into  a  string 

*  (by  calling  toString ()  on  each  object),  separated  by  separator. 

*/ 

public  static  String  concat (  Object []  objects.  String  separator  )  { 

if  (ob jects==null) 
return 

int  len  =  objects . length; 
if  (len  ==  0) 
return 

StringBuffer  result=  new  StringBuffer  (len*10) ; 
result . append (ob jects [ 0 ] . toString ( ) ) ; 
for  (int  i=l;  iclen;  i++)  { 

result . append (  separator  ); 
result . append (  ob jects [ i ]. toString ( )  ); 

} 

return  result . toString ( ) ; 
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} 

/** 

*  Convenience  function  to  simplify  call  to 

*  <a  href="#stripAll (StringBuffer, String) "> 

*  stripAll (  StringBuffer  str,  String  charsToStrip  )  </a> 

*/ 

public  static  String  stripAll (  String  str.  String  charsToStrip  )  { 

return  stripAll (new  StringBuf fer (str) ,  charsToStrip) . toString () ; 

} 


/** 

*  Strip  all  characters  found  in  the  charsToStrip  string 

*  from  the  specified  string. 

*  @param  str  The  string  where  characters  are  to  be  stripped  from. 

*  @param  charsToStrip  The  string  containing  the  characters  to  be  stripped 

*  from  "str". 

*  ©return  The  specified  StringBuffer  str. 

*/ 

public  static  StringBuffer  stripAll (  StringBuffer  str.  String  charsToStrip  )  { 

int  len  =  str . length () ; 
for  (int  i=len-l;  i>=0;  i — )  { 

if  (  charsToStrip. indexOf (str .charAt (i) ) !=-l)  { 

str . deleteCharAt (i)  ; 


return  str; 


/** 

*  Converts  the  first  character  of  the  given  string  to  upper-case. 
*/ 

static  public  String  capitalize (  String  val  )  { 

if  (val . length () ==0) 
return  ""; 

return  Character . toUpperCase (val . charAt (0) )  +  val . substring  (1); 


/** 

*  Converts  the  first  character  of  the  given  string  to  lower-case. 
*/ 

static  public  String  uncapitalize (  String  val  )  { 

if  (val . length () ==0) 
return  ""; 

return  Character . toLowerCase (val . charAt (0) )  +  val . substring ( 1 ) ; 
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} 

static  void  p (String  s)  { 
System. out .println (s)  ; 

} 


10.  TranslationAttribute.java 

package  mil . navy . nps . cs . oomi . translator; 

import  java . lang . ref lect . Method; 
import  java . beans . * ; 

import  java . util . List ; 
import  java . util . Arrays ; 
import  java . util . Iterator ; 
import  java . util . LinkedList ; 
import  java . util . ArrayList ; 

import  mil . navy . nps . cs . oomi . f iom. FCRInstance; 
import  mil . navy . nps . cs . oomi . f iom. CCRInstance; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 

/** 

*  Describes  an  attribute  of  a  class  in  the  FIOM. 

*  An  attribute,  if  not  a  Java  primitive  type,  can  be  a  parent  to 

*  other  attributes,  forming  a  tree  structure  that  reflects  the  structure  of 

*  this  non-primitive  attribute. 

*  <p> 

*  An  Attribute  can  be  decomposed  into  its  child  attributes, 

*  but  the  creator  of  this  object  can  prevent  the  expansion  of  this  object 

*  into  its  composing  attributes  by  setting  Expandable  property  to  false. 

*  <pre> 

*  isExpandable ( )  ==>  at  least  one  child  attribute, 

*  </pre> 

*  but  having  child  attributes  does  not  imply  that  the  attribute  is  expandable. 

*  <p> 

*  An  Attribute  is  basically  immutable,  except  for  the  child  attributes  that 
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it  is  composed  of. 


*/ 

public  class  TranslationAttribute  extends  MethodParameter  { 

/** 

*  The  parent  of  this  TranslationAttribute. 

*/ 

TranslationAttribute  _parent  =  null;  //  defaults  to  null,  indicating  no  parent 

/** 

*  All  the  children  that  composes  this  TranslationAttribute. 


*/ 

protected  List  _children  =  null;  //  allocated  only  when  used 

/** 

*  Determines  if  this  TranslationAttribute  should  be  expanded  into  its  composite 

*  TranslationAttributes . 

*  It  is  up  to  the  creator  of  this  TranslationAttribute  to  decide  if 
TranslationAttribute 

*  can  be  further  expanded  into  its  composite  TranslationAttributes. 

*/ 

boolean  _expandable  =  false;  //  defaults  to  false 

/** 

*  Determines  if  this  TranslationAttribute  is  an  indexed  attribute,  corresponding 

*  to  a  JavaBean  Index  Property. 

*/ 

boolean  _indexed  =  false; 


private  void  setExpandable (boolean  val)  { 
_expandable  =  val; 

} 

protected  void  set Indexed (boolean  v)  { 
_indexed  =  v; 

} 


/** 

*  Returns  if  this  TranslationAttribute  is  decomposable  into  its  composite  attributes. 
*/ 

public  boolean  isExpandable ( )  { 

return  _expandable; 


this 
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/** 

*  No-argument  constructor,  generally  not  used. 

*/ 

protected  TranslationAttribute ( )  { 

//  do  nothing. 

} 

/** 

*  Creates  a  new  TranslationAttribute,  with  a  given  parent. 

*/ 

public  TranslationAttribute (  TranslationAttribute  parent. 

String  attributeType,  String  attributeName 

)  { 

super (attributeType,  attributeName) ; 
setParent (parent) ; 

} 

public  TranslationAttribute (String  attributeType,  String  attributeName)  { 
super (attributeType,  attributeName) ; 

} 

/** 

*  An  attribute  can  only  have  the  option  of  Expandable  only  if  it  has  the 

*  atributeType  as  a  Class. 

*/ 

public  TranslationAttribute (  TranslationAttribute  parent. 

Class  attributeType,  String  attributeName, 
boolean  expandable)  { 
super (attributeType,  attributeName) ; 
setParent (parent) ; 
setExpandable (expandable)  ; 

} 

/** 

*  An  attribute  can  only  have  the  option  of  Expandable  only  if  it  has  the 

*  atributeType  as  a  Class. 

*/ 

public  TranslationAttribute (  TranslationAttribute  parent. 

Class  attributeType,  String  attributeName, 
boolean  expandable, 
boolean  indexed  )  { 

super (attributeType,  attributeName) ; 
setParent (parent) ; 
setExpandable (expandable) ; 
setlndexed (indexed)  ; 
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/ 


*  Creates  a  copy  of  the  given  TranslationAttribute . 

*/ 

public  TranslationAttribute (TranslationAttribute  attr)  ( 
super (attr . getType ( ) ,  attr . getName ( ) ) ; 


/** 

*  Sets  the  parent. 

*/ 

protected  void  setParent (TranslationAttribute  val)  ( 
this._parent  =  val; 

/* 

//  remove  from  current  parent,  if  applicable 
if  (this ._parent ! =null )  { 

this ._parent . removeChild (this) ; 

) 

//  change  to  the  new  parent 
this._parent  =  val; 
if  (_parent ! =null) 

//  notify  new  parent  of  this  child  attribute 
this ._parent . addChild (val)  ; 

*/ 

} 

public  TranslationAttribute  getParentO  ( 
return  this ._parent ; 

) 

protected  List  getChildren ( )  { 

if  (isExpandable  ( ) )  { 

if  (_children  ==  null  )  { 

TranslationAttribute [ ]  childs  =  extractChildren ( ) ; 
_children  =  Arrays . asList (childs) ; 


return  _children; 


/** 

*  Adds  a  child  to  this  attribute,  calls  the  setParent ()  method  of  the  child. 
*/ 

protected  void  addChild (TranslationAttribute  child)  ( 

//  should  not  call  getChildren () ,  will  go  into  infinite  loop 
if  (_children==null )  ( 

_children  =  new  ArrayListO; 
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} 

_children . add (child)  ; 
child. setParent (this)  ; 


^  -k  -k 


*  Removes  the  given  child,  calls  the  setParent ()  method  of  the  child. 
*/ 


protected  void  removeChild (TranslationAttribute  child)  { 
if  (isExpandable ( ) ) 

this . getChildren ( )  . remove (child)  ; 
child. setParent (null)  ; 


/** 

*  Returns  the  child  attribute  at  i. 

*  ©return  Returns  the  child  attribute  at  i, 

*  null  if  no  child  at  i  or  if  this  Attribute  is 

*  not  expandable. 

*/ 

public  TranslationAttribute  childAt (int  i)  { 
if  (isExpandable () ) 

return  (TranslationAttribute) getChildren ( ) .get(i); 
else 

return  null; 


/** 

*  Returns  an  Iterator  for  the  children. 

*  ©return  Returns  an  Iterator  for  the  children, 

*  null  if  this  TranslationAttribute  is  not  expandable. 
*/ 

public  Iterator  childrenlterator ( )  { 

if  (isExpandable () ) 

return  this . getChildren ( ) . iterator ( ) ; 
else 

return  null; 


/** 

*  Inspects  the  given  class  and  extracts  all  the  attributes. 

*  Attributes  are  defined  as  having  public 

*  accessors  with  names  like  get { AttributeName }  and 

*  public  mutators  with  names  like  set {AttributeName } . 

*  The  fourth  character  of  the  method  must  be  an  uppercase  letter. 

*  <p>For  example,  the  following  class  : 
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*  <pre> 

*  class  ClassA  { 

*  public  type  getAtt'10 

*  public  type  setAttl(pO)  {...} 

*  public  type  getAtt2()  {...} 

*  public  type  setAtt2(pO) 

*  } 

*  </pre> 

*  will  have  attributes:  Attl,  Att2. 

*  <p> 

*  <b>  NOTE:  Assumption  made  is  that  any  get/set  will  be  matched  by  a  corresponding 

*  get/set,  this  method  currently  does  not  check  if  there  is  an  actual  match 

*  and  will  only  process  all  the  "get"  methods  without  parameters. 

*  </b> 

*  <p> 

*  <b>  NOTE:  The  getClassO  method  is  excluded. </b> 

*  <p> 

*  Descendants  may  override  this  method  or  extractAttributeName ( ) 

*  to  change  the  extraction  logic. 

*  <p> 

*  A  class  may  have  attributes  whose  type  is  that  of  the  containing 

*  class,  that  is,  cyclic  references  may  occur.  For  example, 

*  <pre> 

*  class  AClass  { 

*  String  si; 

*  int  inti; 

*  Class  aClass; 

*  } 

*  </pre> 

*  ©return  Returns  an  array  of  the  TranslationAttribute  instances  if  attributes  are 

*  found,  else  returns  null. 

*  ©see  #extractAttributeName (String) 

*/ 

protected  TranslationAttribute!]  extractChildren (  )  ( 

try  { 

TranslationAttribute]]  children  =  extractAttributes (this ,  this . getTypeAsClass ( ) ) ; 
return  children; 

} 

catch  (Exception  ex)  { 

//  this  Attribute  is  not  expandable 
return  null; 

} 

} 
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protected  TranslationAttribute [ ]  extractChildren2 (  )  { 


//  list  methods 

Method [ ]  methods=getTypeAsClass ( ) . getMethods ( ) ; 
int  len=methods . length; 

String  attributeName; 

TranslationAttribute  attribute; 

List  result  =  new  ArrayList ( 10 )  ; 
for  (int  i=0;  iclen;  i++)  { 

Method  m  =  methods [i]  ; 

attributeName  =  extractAttributeName (m. getName ())  ; 
if  (attributeName ! =null  &&  m. getParameterTypes ( ) . length==0)  { 
attribute  =  new  TranslationAttribute (  this, 

m . getReturnType ( ) , 
attributeName, 

isExpandableType (  m. getReturnType ( )  )  )  ; 

result . add (attribute) ; 

//System. out .println ( "Attribute :  "  +  attribute); 


if  (len>0) 

return  (TranslationAttribute []) result . toArray (new  TranslationAttribute [ result . size ( ) ] ) 
else 

return  null; 


/** 

*  Given  a  method's  name,  determines  if  it  is  an  accessor  that 

*  matches  the  get*  pattern  and  extracts  the  attribute  name. 

*  <b>The  getClassO  method  is  excluded. </b> 

*  Looks  for  "get"  methods  only,  since  "get"  methods  will  provide  information 

*  on  the  type  of  the  attribute. 

*  ©return  Returns  the  attribute  name  if  method  is  an  accessor  ("get"  method), 

*  else  returns  null. 

*/ 

protected  String  extractAttributeName (  String  methodName  )  { 

if  (methodName . length () >3)  { 

if  (methodName . equals ("getClass") ) 
return  null; 

char  charAt3  =  methodName . charAt (3) ; 
if  (Character . isUpperCase (charAt3) )  { 

if  (methodName . indexOf ( "get ") ==0  )  { 

//  capitalize  the  fourth  character 
charAt3  =  Character . toUpperCase (charAt3) ; 
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return  charAt3  +  methodName . substring (4) ; 


} 

} 

} 

return  null; 


/** 

*  Determines  if  the  given  type  should  be  expandable. 

*/ 

protected  static  boolean  isExpandableType (  Class  type  )  { 

return  (  FCRInstance . class . isAssignableFrom (type)  | | 
CCRInstance . class . isAssignableFrom (type)  ) ; 


/** 

*  Determines  if  this  TranslationAttribute  is  an  indexed  attribute, 

*  that  is,  a  JavaBean  indexed  property. 

*/ 

public  boolean  islndexed()  { 
return  _indexed; 


/** 

*  Inspects  the  given  class  and  extracts  all  the  attributes. 

*  Attributes  are  defined  as  synonymous  with  JavaBeans  properties, 

*  the  specified  class  should  therefore  conform 

*  to  the  JavaBeans  specification. 

*  <p> 

*  The  following  attributes  are  ignored: 

*  <ol> 

*  <li>  has<Name> 

*  <li>  isValid 

*  </ ol> 

*  <p> 

*  A  class  may  have  attributes  whose  type  is  that  of  the  containing 

*  class,  that  is,  cyclic  references  may  occur.  For  example, 

*  <pre> 

*  class  AClass  { 

*  String  si; 

*  int  inti; 

*  Class  aClass; 

*  } 

*  </pre> 

*  ©return  Returns  an  array  of  the  TranslationAttribute  instances  if  attributes  are 
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found,  else  returns  an  empty  array. 


*/ 


public  static  TranslationAttribute [ ]  extractAttributes (  TranslationAttribute  parent, 
theClass  ) 


throws  mil . navy . nps . cs . oomi . exceptions . 

IntrospectionException  { 


try  { 

boolean  indexed  =  false; 

Class  attrType; 

Beanlnfo  beanlnfo  =  Introspector . getBeanlnfo (theClass) ; 
PropertyDescriptor [ ]  propDescs  =  beanlnfo . getPropertyDescriptors () ; 
List  result  =  new  ArrayList (propDescs . length-1 ) ; 

String  attrName; 

for  (int  i=0;  i<propDescs . length;  i++)  { 

attrName  =  propDescs [ i ]. getName () ; 
if  (attrName . equals ( "class " ) 

| |  attrName . equals ( "valid" ) 

) 


continue; 


indexed  =  propDescs [i]  instanceof  IndexedPropertyDescriptor; 

/ /p (  attrName  +  "  "  +  propDescs [ i ]. getPropertyType (). getName ()) ; 

attrType  =  propDescs [ i ]. getPropertyType () ; 

if  (indexed)  { 

if  (! attrType . isArray () )  { 

throw  new  Exception (  attrName  +  "  must  be  an  array."  ); 


result . add (new  TranslationAttribute (  parent, 
attrType,  attrName, 
isExpandableType (attrType) , 
indexed  ) ) ; 

} 

return  (TranslationAttribute [] )  result . toArray (new  TranslationAttribute [ result . siz 

} 

catch  (Exception  ex)  { 

throw  new  mil . navy . nps . cs . oomi . exceptions . IntrospectionException (ex) ; 


Returns  the  full  access  path  from  this  TranslationAttribute ' s 
highest  ancestor. 


Class 


0  ]  )  ; 
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/ 


public  String  path (  boolean  includeRoot,  String  separator  )  ( 

List  path  =  new  ArrayList  (5) ; 

TranslationAttribute  curr  =  this; 

while  (curr!=null)  { 
path . add (curr )  ; 
curr  =  curr . getParent { )  ; 

} 

StringBuffer  result  =  new  StringBuf fer ( ) ; 

Object!]  objs  =  path . toArray ( )  ; 

TranslationAttribute  attr; 

int  start  =  ( includeRoot ) ?obj s . length-1 : obj s . length-2 ; 

attr  =  (TranslationAttribute)  objs [start]; 

result . append (attr . getName ( ) ) ; 

for  (int  i=start-l;  i>=0;  i — )  ( 

attr  =  (TranslationAttribute)  objs[i]; 
result . append (separator  +  attr . getName ()) ; 

} 

return  result . toString ( )  ; 


/** 

*  Returns  the  full  access  path  from  this  TranslationAttribute ' s 

*  highest  ancestor. 

*/ 

public  String  readPath (  boolean  includeRoot  )  ( 

List  path  =  new  ArrayList (5)  ; 

TranslationAttribute  curr  =  this; 
while  (curr!=null)  { 
path . add (curr )  ; 
curr  =  curr . getParent () ; 

} 

StringBuffer  result  =  new  StringBuf fer () ; 

Object!]  objs  =  path .  toArray  ()  ; 

TranslationAttribute  attr; 

int  start  =  ( includeRoot ) ?obj s . length-1 : obj s . length-2 ; 
for  (int  i=start;  i>=0;  i — )  ( 

attr  =  (TranslationAttribute)  objsfi]; 

result . append (". get "  +  StringHelper . capitalize (attr . getName () )  +  "()"); 

} 

return  result . toString ( )  ; 

} 
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*  Lists  this  TranslationAttribute  object  and  all  its  ancestors  in  an  array. 

*  ©return  An  array  that  holds  this  object  and  all  its  ancestors  ordered 

*  from  greatest  ancestor  (Oth  element)  down  to  this  object  (last  element) . 
*/ 

public  TranslationAttribute [ ]  pathToArray ( )  { 

List  path  =  new  ArrayList (5) ; 

TranslationAttribute  curr  =  this; 
while  (curr !=null)  { 
path . add (curr )  ; 
curr  =  curr . getParent  ( ) ; 

} 

TranslationAttribute [ ]  result  =  new  TranslationAttribute [path . size ()] ; 

/ /  reverse  the  order 
if  (result . length>0)  { 
int  i  =  result . length-1 ; 

Iterator  iter  =  path . iterator () ; 

TranslationAttribute  a; 
while  (iter . hasNext ( ) )  { 

a  =  (TranslationAttribute) iter . next ()  ; 
result [ i ]  =  a; 


return  result; 


/** 

*  Returns  the  full  access  path  source  code  of  the  "hasser" 

*  of  this  TranslationAttribute. 

*  For  example,  for  an  attribute  B  in  object  obj,  accessible  by  the  call 

*  ' obj . getA ( )  . getB  ( )  ' , 

*  this  method  returns:  ' obj. getA () .hasB() '  if  includeRoot  is  true, 

*  and  returns  '  .getA() .hasB() '  if  includeRoot  is  false, 

public  String  hasserText (  boolean  includeRoot  )  { 


} 

*/ 

/** 

*  Returns  the  source  code  of  the  has<AttributeName>  method 

*  for  this  TranslationAttribute. 

*/ 

public  String  hasMethodText ( )  { 

return  "has"  +  StringHelper . capitalize  (  this . getName ( )  )  +  "()"; 

} 
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Returns  the  full  access  path  to  write  value  from  this  TranslationAttribute ' s 
root  down  to  this  TranslationAttribute. 

©param  includeRoot  Whether  to  include  the  root  attribute. 

@param  value  The  string  that  represents  the  value  for  the  write  operation. 

©return  Returns  the  full  access  path  to  write  value  from  this  TranslationAttribute ' s 
root  down  to  this  TranslationAttribute. 


*/ 


public  String  writePath (  boolean  includeRoot,  String  value  )  { 

List  path  =  new  ArrayList  (5) ; 

TranslationAttribute  curr  =  this; 
while  (curr !=null)  { 
path . add (curr)  ; 
curr  =  curr . getParent ( ) ; 


StringBuffer  result  =  new  StringBuf f er ( ) ; 

Object []  objs  =  path . toArray ( ) ; 

TranslationAttribute  attr; 

int  start  =  (includeRoot ) ?objs . length-1 : objs . length-2; 
for  (int  i=start;  i>=l;  i — )  { 

attr  =  (TranslationAttribute)  objs[i]; 

result . append (". get "  +  StringHelper . capitalize (attr . getName () )  +  "()"); 


attr  =  (TranslationAttribute)  objs[0]; 
result . append (". set "  + 

StringHelper . capitalize (attr . getName ( ) )  + 
" ( "  +  value  +  " ) " ) ; 
return  result . toString ( )  ; 

} 


public  static  void  d(  TranslationAttribute [ ]  array  )  { 

for  (int  i=0;  i<array . length;  i++  )  { 

System. out . print In (array [ i ] ) ; 

} 

} 

} 


11.  T  ranslationAttributeMapping.j  ava 

package  mil . navy . nps . cs . oomi . translator; 

/** 
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*  Holds  the  many-to-one  mapping  from  attributes  of 

*  one  class  to  the  attribute  of  another  class. 

*/ 

public  class  TranslationAttributeMapping  ( 


/** 

*  Source  attributes. 

*/ 

protected  TranslationAttribute  _sourceAttr [ ] ; 

/** 

*  Target  attribute. 

V 

protected  TranslationAttribute  _targetAttr; 

/** 


*/ 

public  TranslationAttributeMapping (  TranslationAttribute  source]],  TranslationAttribute 
target)  { 

_sourceAttr  =  new  TranslationAttribute [source . length]  ; 

System . arraycopy (  source,  0,  _sourceAttr,  0,  source . length  ); 

_targetAttr  =  target; 

} 


/** 

*  Returns  a  copy  of  the  array  of  from  attributes . 

*/ 

public  TranslationAttribute]]  getSourceAttributes ( )  ( 

TranslationAttribute]]  result  =  new  TranslationAttribute [_sourceAttr . length] ; 
System. arraycopy (_sourceAttr,  0,  result,  0,  _sourceAttr . length) ; 
return  result; 


/** 

*  Returns  the  target  attribute. 

V 

public  TranslationAttribute  getTargetAttribute ( )  ( 

return  _targetAttr; 

) 
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*  Returns  a  string  of  the  source  attributes  separated  by  the 

*  given  separator. 

*/ 

public  String  sourceAttributesAsString (  String  nestedAttrSeparator, 

String  separator, 
boolean  includeRoot, 
boolean  includeType)  { 

if  (_sourceAttr==null ) 
return 

int  len  =  _sourceAttr . length; 
if  (len  ==  0) 
return 

StringBuffer  result=  new  StringBuf fer (len*10) ; 
if  (includeType) 

result . append (_sourceAttr [ 0 ]. getType ( )  +  "  "); 
result . append (_sourceAttr [ 0 ] .path (includeRoot,  nestedAttrSeparator) ) ; 
for  (int  i=l;  i<len;  i++)  { 

result . append (  separator  ); 
if  (includeType) 

result . append (_sourceAttr [ i ]. getType ( )  +  "  "); 
result . append (  _sourceAttr [ i ] .path (includeRoot ,  nestedAttrSeparator)  ) 

} 

return  result .  toStringO; 


/** 

*  Converts  to  string  of  the  form: 

*  " sourcel_type  sourcel_name,  source. 
*/ 


12.  TranslationClassDefinition.java 

package  mil . navy . nps . cs . oomi . translator; 

import  java . util . List ; 
import  java . util . Iterator ; 
import  java . util . ArrayList ; 
import  java . util . Set ; 
import  java . util . HashSet ; 
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import  mil . navy . nps . cs . oomi . f iom. FCRInstance; 
import  mil . navy . nps . cs . oomi . f iom. CCRInstance; 

/** 

*  @author  LSC 

*  ©version  1.0 
*/ 

public  class  TranslationClassDef inition  extends  ClassDef inition  { 

/** 

*  The  FCR  class  name. 

*/ 

protected  String  _fcr; 

/** 

*  The  CCR  class  name. 

*/ 

protected  String  _ccr; 

public  TranslationClassDef inition (String  className,  String  parentName, 

String  fcrName,  String  ccrName)  { 

super (className,  parentName); 
this._fcr  =  fcrName; 
this._ccr  =  ccrName; 


/** 

*  Generates  MethodDef inition  that  will  override  the  abstract  methods 

*  of  the  base  class. 

*  Only  call  this  method  after  all  "ccrToFcr_"  and  "fcrToCcr_"  methods 

*  of  this  object  had  been  defined. 

*/ 

public  void  generateAbstractOverrides ( )  { 

String  fcrName  =  this . getFcr ( ) ; 

String  ccrName  =  this . getCcr ( )  ; 

//  the  toFcr ()  method 
MethodDef inition  toFcrMethod 

=  new  MethodDef inition (  "public",  FCRInstance . class . getName () ,  "toFCR") 
toFcrMethod. addParam (  CCRInstance . class . getName () ,  "ccrlnstance"  ); 
generateBody (  fcrName,  toFcrMethod,  "ccrToFcr_", 
ccrName) ; 

//  the  toCcr()  method 
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MethodDef inition  toCcrMethod 


=  new  MethodDef inition (  "public",  CCRInstance . class . getName () ,  "toCCR"); 
toCcrMethod. addParam (  FCRInstance . class . getName () ,  " f crlnstance"  ); 
generateBody (  ccrName,  toCcrMethod,  "fcrToCcr_", 
fcrName  ) ; 

_methods . add (toCcrMethod) ; 

_methods . add (toFcrMethod) ; 


/** 

*  Generates  the  body  of  either  "toFCRO"  or  "toCCR  ()"  methods. 

*  @param  target  Either  value  of  _fcr  or  _ccr. 

*  @param  method  The  toFCRO  or  toCCR ()  method  whose  body  is  to  be  generated. 

*  @param  prefix  The  "ccrToFcr_"  or  "fcrToCcr_"  attribute  translation 

*  methods'  prefix  to  be  called  by  the  method  parameter. 

*/ 

protected  void  generateBody (  String  target,  MethodDef inition  method. 

String  prefix. 

String  actualParamType  )  { 

/ /  the  method  contains  only  one  parameter 
MethodParameter  param  =  method. paramsToArray ( ) [0]; 

//  The  parameter  will  be  typecast  to  the  actual  type  in  a  local  variable  "obj". 

String  ob jNamePref ix  =  "obj";  //param. getName ( )  ; 

List  body  =  new  ArrayList(); 

Iterator  iter  =  _methods . iterator ()  ; 

MethodDef inition  callee; 

StringBuffer  calleeParamStr  =  new  StringBuf fer (100) ; 

MethodParameter [ ]  calleeParams; 

//  generate  code  to  type-cast  method's  actual  parameter  to  appropriate  type 
body. add (  actualParamType  +  "  obj  =  "  + 

"("  +  actualParamType  +  ")  "  +  param. getName ( )  +  ); 

//  generate  code  to  create  instance  of  result 

body. add (  target  +  "  result  =  new  "  +  target  +  "();"  ); 

body . add ( " " ) ; 

List  codeBody  =  new  ArrayList (20) ; 

AttributeParentAllocationCodeGenerator  gen  =  new  AttributeParentAllocationCodeGenerator ( ) 
while  (iter . hasNext  ( ) )  { 

calleeParamStr . set Length (0) ; 

callee  =  (MethodDef inition)  iter. next ()  ; 

if  (callee . getName (). indexOf (prefix) ==0)  { 
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calleeParams  =  callee . paramsToArray ( ) ; 


//  there  should  be  at  least  one  parameter 
calleeParamStr . append (  ob jNamePref ix 

+  ( (TranslationAttribute) calleeParams [0] ). readPath (false)  ); 

//calleeParamStr . append (  ",  "  +  hasParam ( (TranslationAttribute) calleeParams [0] )  ) 
for  (int  i=l;  i<calleeParams . length;  i++)  ( 

calleeParamStr . append (  ",  "  +  ob jNamePref ix 

+  (  (TranslationAttribute) calleeParams [i] ). readPath (false)  ); 

/* 

+  TranslationFactory . f irstCharToUpper (calleeParams [i] . getName ( ) ) 

+  "()"); 

*/ 

} 


//  sample:  calleeStr  =  f crToCcr_. . . (ccrlnstance . getA . get . . . ) ; 

String  calleeStr  =  callee . getName ( )  +  "("  +  calleeParamStr  +  ")"; 
TranslationAttribute  attr  = 

( (AttributeTranslationMethod) callee) . getTargetAttribute () ; 
codeBody . add ( "result "  +  attr .writePath (false,  calleeStr)  +  ";"); 
gen . generate (attr) ; 


body . addAll (gen . code ( )  )  ; 

body . add ( " " )  ; 

body . addAll (codeBody) ; 

//  generate  code  to  return  the  result 
body . add ( " " ) ; 

body . add (" return  result;"); 
method. setBody (body)  ; 


/** 

*  Generates  the  code  that  will  allocate  attributes'  parents. 

V 

static  class  AttributeParentAllocationCodeGenerator  { 

/** 

*  List  of  code  generated  by  this  class  since  its  creation. 

*/ 

List  _generatedCode  =  new  ArrayList (20)  ; 

/** 

*  Generates  the  code  that  will  allocate  memory  for  the  parent  of  the 
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*  specified  Attribute, 

*  if  it  has  a  parent  attribute,  that  is,  attr . getParent ( ) !=null. 

*  Also  generates  the  code  for  the  creation  of  the  specified  Attribute's 

*  higher  ancestors,  if  such  code  had  not  already  been  generated. 

*/ 

public  void  generate (  TranslationAttribute  attr  )  { 

if  (attr==null) 
return; 

TranslationAttribute  attrParent  =  attr . getParent () ; 

//  only  attributes  with  parent  should  be  created,  that  is,  attributes 
//  other  than  the  root  attribute 
if  (attrParent ! =null)  { 

//  if  attrParent  is  not  the  root  attribute,  generate  the  allocation 
//  code  for  its  parent 
if  (attrParent . getParent ()! =null)  { 

String  result=""; 

Class  attrParentClass  =  attrParent . getTypeAsClass () ; 
if  (  FCRInstance . class . isAssignableFrom (attrParentClass)  | | 
CCRInstance . class . isAssignableFrom (attrParentClass)  ) 
result  =  ("result"  +  attrParent .writePath (false, 

"new  "  +  attrParent . getType ( )  +  "()")  +  ";"  ) 

generate (attrParent) ; 
if  (! lineExists (result ) )  { 

_generatedCode . add (result ) ; 


public  List  code ()  { 

return  _generatedCode; 

} 

public  boolean  lineExists (String  line)  { 

Iterator  i  =  _generatedCode . iterator ()  ; 

String  currLine; 
while  (i . hasNext ( ) )  { 

currLine  =  (String)  (i.nextO); 
if  (currLine . equals (line)  ) 
return  true; 

} 

return  false; 

}  //  class  AttributeParentAllocationCodeGenerator 
}  //  class  AttributeCreationCodeGenerator 
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/** 

*  Generates  the  source  code  for  the  has<AttributeName>  parameter, 
public  String  hasParam {TranslationAttribute  attr)  { 


} 


V 


/* 

*  Generates  code  that  allocates  all  the  attributes 

*  in  the  path  of  the  specified  attribute 
public 

*/ 

public  String  getFcrO  { 
return  _fcr; 

} 

public  String  getCcrO  { 
return  _ccr; 


13.  TranslationFactory.java 

package  mil . navy . nps . cs . oomi . translator; 


import 

import 

import 

import 

import 

import 

import 


java . lang . reflect .Method; 

java . util . List ; 

java . util . Array List ; 

java . util . Set ; 

java. util . HashSet; 

java . beans . * ; 

j  ava .util.*; 


import  mil . navy . nps . cs . oomi . exceptions . * ; 

import  mil . navy . nps . cs . oomi . f iom. AbstractTranslation; 


/** 

*  A  factory  to  create  various  FIOM  translation  specific  class  instances. 


*  @author  LSC 

*  ©version  1 . 0 


*/ 


280 


public  class  TranslationFactory  { 


/** 

*  The  root  class  for  all  translations. 

*/ 

static  final  Class  PARENT_CLASS  =  AbstractTranslation . class; 

/** 

*  This  class  should  never  be  instantiated. 

*/ 

protected  TranslationFactory ( )  { 

} 

public  final  static  String  METHOD_MODIFIERS  =  "public"; 

/** 

*  Creates  a  new  MethodDef inition  instance  for  transforming 

*  CCR  attributes  to  a  FCR  attribute. 

*  A  copy  of  the  ccrAttrs  is  made. 

*  First  letter  of  each  parameter  is  forced  to  lowercase,  in  conformance 

*  with  conventional  Java  source  code  standard. 

*/ 

public  static  AttributeTranslationMethod  newCcrToFcrMethod ( 

TranslationAttribute  fcrAttr, 
TranslationAttribute [ ]  ccrAttrs  )  { 

MethodParameter [ ]  params  =  new  MethodParameter [ccrAttrs . length] ; 
System. arraycopy (  ccrAttrs,  0,  params,  0,  ccrAttrs . length  ); 
AttributeTranslationMethod  result 

=  new  AttributeTranslationMethod (  ME T HOD_MOD I F I ERS , 

fcrAttr . getType ( ) , 

"ccrToFcr_"  +  fcrAttr .path (false, "_") , 
fcrAttr  ) ; 

result . addParams (params) ; 
return  result; 


/** 

*  Generates  a  MethodDef inition  with  signature  to  facilitate  transforming 

*  the  source  attributes  into  the  target  attribute. 

*  A  copy  of  the  fcrAttrs  is  made. 

*  First  letter  of  each  parameter  is  forced  to  lowercase,  in  conformance 

*  with  conventional  Java  source  code  standard. 

*/ 
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public  static  AttributeTranslationMethod  newCcrToFcrMethod ( 


TranslationAttributeMapping  attrMapping)  { 
AttributeTranslationMethod  result 

=  newCcrToFcrMethod (attrMapping . getTargetAttribute ( ) , 

attrMapping . getSourceAttributes () ) ; 

return  result; 


/** 

*  Creates  a  new  MethodDef inition  instance  for  transforming 

*  FCR  attributes  to  a  CCR  attribute. 

*  A  copy  of  the  fcrAttrs  is  made. 

*/ 

public  static  AttributeTranslationMethod  newFcrToCcrMethod ( 

TranslationAttribute  ccrAttr, 
TranslationAttribute [ ]  fcrAttrs  )  { 

MethodParameter [ ]  params  =  new  MethodParameter [ fcrAttrs . length] ; 
System. arraycopy (  fcrAttrs,  0,  params,  0,  fcrAttrs . length  ); 
AttributeTranslationMethod  result 

=  new  AttributeTranslationMethod (  ME T HOD_MOD I F I ERS , 

ccrAttr . getType ( ) , 

"fcrToCcr_"  +  ccrAttr . path ( false, ) , 
ccrAttr  ) ; 

result . addParams (params) ; 
return  result; 


/** 

*  Generates  a  MethodDef inition  with  signature  to  facilitate  transforming 

*  the  source  attributes  into  the  target  attribute. 

*/ 

public  static  AttributeTranslationMethod  newFcrToCcrMethod ( 

TranslationAttributeMapping  attrMapping)  { 
AttributeTranslationMethod  result 

=  newFcrToCcrMethod (attrMapping . getTargetAttribute ( ) , 

attrMapping . getSourceAttributes () ) ; 

return  result; 


/** 

*  Generates  attribute  translation  methods  from  FCR  to  CCR  based 

*  on  the  AttributeMapping  array. 

*/ 

public  static  AttributeTranslationMethod [ ]  newFcrToCcrMethods  ( 

TranslationAttributeMapping [ ]  mappings  )  { 
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AttributeTranslationMethod [ ]  result 

=  new  AttributeTranslationMethod [mappings . length]  ; 
for  (int  i=0;  icmappings . length;  i++)  { 

result [i]  =  newFcrToCcrMethod (mappings [ i ]) ; 

} 

return  result; 


/** 

*  Generates  attribute  translation  methods  from  CCR  to  FCR  based 

*  on  the  AttributeMapping  array. 

*/ 

public  static  AttributeTranslationMethod [ ]  newCcrToFcrMethods  ( 

TranslationAttributeMapping [ ]  mappings  )  { 

AttributeTranslationMethod [ ]  result 

=  new  AttributeTranslationMethod [mappings . length]  ; 
for  (int  i=0;  i<mappings . length;  i++)  { 

result [i]  =  newCcrToFcrMethod (mappings [ i ]) ; 

} 

return  result; 


j  ~k  ~k 


*  Returns  a  new  JavaFileDef intion  instance  for  the  given  fcr  and  ccr  classes. 


*/ 

public  static  JavaFileDef inition 

newFiomTranslationFile  (  String  packageNamePref ix. 

String  fcr.  String  ccr)  { 

/* 

String  className  =  StringHelper . replaceAll (fcr, ) 

+  " _ "  //  double  underscores 

+  StringHelper . replaceAll (ccr, " . " , ) ; 

*/ 

ParsedClassName  fcrClassName  =  ParsedClassName .parseClassName (fcr) ; 
ParsedClassName  ccrClassName  =  ParsedClassName .parseClassName (ccr) ; 

String  className  =  fcrClassName . className ( )  +  _ "  +  ccrClassName . className ( ) 

ClassDef inition  classDef 

=  new  TranslationClassDef inition (  className, 

PARENT_CLASS . getName ( )  , 
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fcr,  ccr  ) ; 

JavaFileDef inition  fileDef  =  new  JavaFileDef inition (classDef )  ; 

f ileDef . setPackageName (packageNamePref ix  +  +  fcrClassName .packageName ( ) 

+  +  ccrClassName .packageName ()) ; 

MethodDef inition  constructor 

=  new  MethodDef inition (  "public",  "",  className  ); 
constructor . setBody ( "init (  "  +  fcr  +  ".class,  "  +  ccr  +  ".class  );"); 
classDef . addMethod (constructor) ; 
return  fileDef; 


/** 

*  Makes  a  Class  instance  for  a  single  dimension  array  with  elements  of  the 

*  specified  qualif iedTypeName . 

*/ 

public  static  Class  makeArrayClass (String  qualif iedTypeName) 

throws  ClassNotFoundException  { 

return  Class . f orName (Ref lectionHelper . encodeToArraySignature (qualif iedTypeName,  1 ) ) 

} 


/** 

*  Converts  the  first  character  of  the  given  string  to  lower-case. 
*/ 

static  public  String  f irstCharToLower (  String  val  )  { 

if  (val . length () ==0) 
return  ""; 

return  Character . toLowerCase (val . charAt (0) )  +  val . substring (1); 


/** 

*  Converts  the  first  character  of  the  given  string  to  upper-case. 
*/ 

static  public  String  f irstCharToUpper (  String  val  )  { 

if  (val . length () ==0) 
return  ""; 

return  Character . toUpperCase (val . charAt (0) )  +  val . substring (1); 


static  void  p (String  s)  { 
System. out .println (s)  ; 

} 
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/** 

*  This  class  holds  the  class  name  broken  down  into  package  name  and  class  name. 
*/ 

class  ParsedClassName  { 

/** 

*  The  class  name. 

*/ 

String  _className  = 

/** 

*  The  package  name . 

*/ 

String  _packageName  = 
public  String  packageName ( )  { 

return  _packageName; 

} 

public  String  className ()  { 

return  _className; 

} 


j  ★  ★ 


*/ 

public  ParsedClassName (  )  { 

} 


/** 

*  Parses  the  specified  class  name  (not  an  inner  class)  into  two  parts: 

*  the  package  name  and  the  class  name  of  the  fully  qualified  class  name. 

*  ©return  A  ParsedClassName  object  with  the  broken  down  class  name. 

*  <br>Example  1:  if  the  input  is  "a.b.c",  the  result  would  be:  { "a .b" , "c" } . 

*  <br>Example  2:  if  the  input  is  "c",  the  result  would  be:  {” ” ,"cn }. 

*  <br>Example  2:  if  the  input  is  the  result  would  be: 

*/ 

public  static  ParsedClassName  parseClassName (  String  className  )  { 

ParsedClassName  result  =  new  ParsedClassName () ; 
if  (className . length () ==0) 
return  result; 

StringBuffer  sb  =  new  StringBuffer (className) ; 
sb . reverse ( ) ; 

/* 

int  len  =  packageName . length () ; 
int  i  =  len-1; 
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while  (i>=0)  { 


*/ 

StringTokenizer  tok  =  new  StringTokenizer (  sb . toString ( ) ,  ); 

result ._className  =  (new  StringBuff er ( (String) tok . nextToken ())). reverse (). toString ( ) 
int  endlndex  =  className . length () -result . className (). length () -1 ; 
if  (endlndex  >  0) 

result ._packageName  =  className . substring (  0,  endlndex  ); 
return  result; 


14.  TranslationGenerator.java 

package  mil . navy . nps . cs . oomi . translator; 

import  java.io.*; 
import  java. util.*; 

/** 

*  This  is  basically  a  general  purpose  code  generator, 

*  based  on  a  JavaFileDef inition  instance. 

*  @author  LSC 

*  ^version  1 . 0 


*/ 

public  class  TranslationGenerator  { 

public  TranslationGenerator  (  )  { 

} 


/** 

*  Generates  the  Java  file  into  outStream. 

*/ 

public  void  generate  (  OutputStream  outStream, 

JavaFileDef inition  javaFileDef  )  { 

Indent  indent  =  new  Indent  ("  "); 
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//  indent  string  is  double-space  characters 
PrintStream  writer  =  new  PrintStream (outStream) ; 

Generat ionlnf o  genlnfo  =  new  Generationlnf o (  writer, 

javaFileDef , 
indent  ) ; 

writePackageName (  genlnfo  )  ; 

genlnfo . writer . print In ( )  ; 
writelmports (  genlnfo  )  ; 

genlnfo . writer . print In ()  ; 
writeClass (  genlnfo  )  ; 

} 


/** 

*  Inner  class  for  holding  write  information. 

*/ 

protected  class  Generationlnf o  { 

PrintStream  writer; 

JavaFileDef inition  javaFileDef; 

Indent  indent; 

public  Generat ionlnf o (PrintStream  writer, 

JavaFileDef inition  javaFileDef, 
Indent  indent)  { 

this. writer  =  writer; 

this . javaFileDef  =  javaFileDef; 

this. indent  =  indent; 

} 


/** 

*  Writes  the  given  statement  with  indent  to  the  Writer 

*  and  appends  a  semi-colon. 

*/ 

protected  void  writeStatement (Generationlnf o  genlnfo.  String  statement)  { 
genlnfo . writer . print (genlnfo . indent  +  statement  +  ";"); 


/** 

*  Writes  the  given  statement  with  indentation 

*  to  the  Writer  and  appends  a  semi-colon  and 

*  a  newline. 

*/ 

protected  void  writeStatementLine (Generationlnf o  genlnfo.  String  statement)  { 
genlnfo . writer . print In (genlnfo . indent  +  statement  +  ";"); 
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} 

final  String  MARKUP_BEGIN  =  "//%%  begin"; 

final  String  MARKUP_END  =  "//%%  end"; 

/** 

*  Marks  the  user  defined  import  section. 

*/ 

final  String  MARKUP_USER IMPORT  =  "import"; 

/** 

*  Marks  the  user  defined  fields  section. 

*/ 

final  String  MARKUP_U S E RF I E LD S  =  "fields"; 

/** 

*  Marks  the  user  defined  methods  section. 

*/ 

final  String  MARKU P_U S E RME T H 0 D S  =  "methods"; 

/** 

*  Marks  the  method  body  section. 

*/ 

final  String  MARKUP_METHODBODY  =  "method_body " ; 

/** 

*  Writes  a  begin  markup  for  tool  processing. 

*/ 

protected  void  writeMarkupBegin (  Generationlnf o  genlnfo,  String  tagName  ){ 
genlnfo . writer . println (  genlnfo . indent  +  MARKUP_BEGIN  +  "  "  +  tagName  ); 

} 


/** 

*  Writes  a  begin  markup  for  tool  processing,  with  comment  after  the  markup. 
*/ 


protected  void  writeMarkupBegin (  Generationlnf o  genlnfo. 

String  tagName,  String  comment 
genlnfo . writer . println (  genlnfo . indent  +  MARKUP_BEGIN  +  "  "  + 

+  "  —  "  +  comment) ; 


)  { 

tagName 


/** 

*  Writes  a  end  markup  for  tool  processing. 

*/ 

protected  void  writeMarkupEnd (  Generationlnf o  genlnfo.  String  tagName  ){ 
genlnfo . writer . println (  genlnfo . indent  +  MARKUP_END  +  "  "  +  tagName  ); 
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/ 


*  If  stringArray  ==  null,  nothing  is  written. 

*/ 

protected  void  writeStringArray (  PrintStream  writer.  Indent  indent. 

String []  stringArray  )  { 

if  ( stringArray ! =null )  { 

for  (int  i=0;  i<stringArray . length;  i++)  { 

writer . print In (  indent  +  stringArray [ i ]  ); 


protected  void  writePackageName (  Generationlnf o  genlnfo  )  { 

if  (  genlnfo . javaFileDef . getPackageName ()! =null  )  { 

writeStatementLine (  genlnfo, 

"package  "  +  genlnfo . javaFileDef . getPackageName ()) ; 


protected  void  writelmports (  Generationlnf o  genlnfo  )  { 

String  imports []  =  genlnfo . javaFileDef . importsToArray () ; 
if  ( import s ! =null )  { 

for  (int  i=0;  i<imports . length;  i++)  { 

writeStatementLine (genlnfo,  "import  "  +  imports [i] ) ; 


genlnfo . writer . print In ( )  ; 

//  User  managed  imports,  each  string  already  includes  the  keyword  "import", 
imports  =  genlnfo . javaFileDef . userManagedlmportsToArray () ; 
writeMarkupBegin (genlnfo,  MARKUP_USER IMPORT) ; 

genlnfo . writer . print In (" //  —  Enter  your  additional  imports  here."); 
if  ( import s ! =null )  { 

for  (int  i=0;  i<imports . length;  i++)  { 

writeStatementLine (genlnfo,  imports [i] ) ; 


writeMarkupEnd (genlnfo,  MARKUP_USER IMPORT) ; 

} 

protected  void  writeClass  (  Generationlnf o  genlnfo  )  { 

ClassDef inition  classDef  =  genlnfo . javaFileDef . getPublicClass () ; 

//  start  the  class  declaration 

genlnfo . writer . print In (  "public  class  " 

+  classDef . getName ( ) 

+  "  extends  " 
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+  classDef . getParentName ( ) 

+  "  {"); 

genlnf o . indent . increaselndent ( ) ; 
writeMarkupBegin (genlnf o,  MARKUP_USERFIELDS ) ; 

genlnf o . writer . print In (genlnf o . indent  +  "//  —  Enter  your  custom  fields  here."); 
writeStringArray (  genlnf o . writer,  genlnfo . indent , 

classDef . userManagedFieldsToArray ( )  ) ; 

writeMarkupEnd (genlnfo,  MARKUP_USERFIELDS) ; 
genlnf o . writer . print In ()  ; 
writeMethods (  genlnfo  )  ; 

//  marks  the  section  for  free-text  entry  for  user-defined  methods 
writeMarkupBegin (genlnfo,  MARKUP_USERMETHODS ) ; 

genlnf o . writer . print In (genlnf o . indent  +  "//  —  Enter  your  custom  methods  here.") 
writeMarkupEnd (genlnfo,  MARKUP_USERMETHODS ) ; 

genlnfo . indent . decreaselndent ( )  ; 

//  closing  curly  brace  for  the  class 
genlnf o . writer . print In (  " } "  ); 


protected  void  writeMethods (  Generationlnf o  genlnfo  )  { 

MethodDef inition  methods [ ] 

=  genlnf o . javaFileDef . getPublicClass ( ) . methodsToArray ( ) ; 
if  (methods ! =null)  { 

for  (int  i=0;  icmethods . length;  i++)  { 

writeMethod (genlnf o,  methods [i] ) ; 
genlnf o . writer . print In ( )  ; 


protected  void  writeMethod (  Generationlnf o  genlnfo, 

MethodDef inition  method  )  { 

String  returnType  =  method. getReturnType ()  ; 
if  (returnType==null) 
returnType=" " ; 

genlnfo . writer . print In (  genlnfo . indent 

+  method. getModifiers ( ) 

+  "  " 

+  returnType 
+  "  " 

+  method. getName ( ) 

+  "  (  " 

+  methodParameters (genlnf o,  method. paramsToArray () ) 
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+  "  )  r  ); 

genlnf o . indent . increaselndent ( )  ; 

writeMarkupBegin (genlnf o,  MARKUP_METHODBODY,  "Enter  method  body  below 
writeStringArray (  genlnf o . writer,  genlnf o . indent , 
method . bodyLinesToArray ( ) )  ; 
writeMarkupEnd (genlnfo,  MARKUP_METHODBODY ) ; 
genlnf o . indent . decreaselndent ( )  ; 
genlnf o . writer . print In (  genlnf o . indent  +  "}"  ); 


*  If  params==null,  empty  string  is  returned. 

*/ 

protected  String  methodParameters (  Generationlnf o  genlnfo, 

MethodParameter  params [ ] )  { 

StringBuffer  result  =  new  StringBuf fer (100) ; 
if  (params ! =null )  { 

for  (int  i=0;  i<params . length;  i++)  { 

if  ( i > 0  &&  i ! =params . length)  { 

//  append  a  comma,  if  not  the  first  and  not  the  last  parameter 
result . append (" ,  "); 

} 

MethodParameter  param  =  params [i]; 

result . append (param. get Type ( )  +  "  "  +  param. getName ()) ; 

} 

return  result . toString  () ; 

} 

else 

return 


/** 

*  Tracks  the  level  of  indentation 

*  and  returns  the  corresponding  indentation  string. 
*/ 

class  Indent  { 

/** 

*  The  current  indentation  string. 

*/ 
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protected  StringBuffer  _indent  =  new  StringBuf fer (20) ; 

/** 

*  The  indent  token. 

*/ 

protected  String  _indentToken; 

/** 

*  The  indent  token's  length. 

*/ 

protected  int  _indentTokenLen  =  0; 

/** 

*  Creates  an  Indent  instance,  with  each  level  indented  by  the  given 

*  indent  token  string. 

*/ 

public  Indent (  String  indentToken  )  { 

set IndentToken (indentToken)  ; 

} 


/** 

*  Increases  indent  level. 

*/ 

public  void  increaselndent ( )  { 

_indent . append (get IndentToken ( ) )  ; 


/** 

*  Decreases  indent  level. 

*/ 

public  void  decreaselndent ( )  { 

int  len  =  _indent . length ()  ; 
if  (len>0)  { 

_indent . delete (  len-_indentTokenLen,  len  ); 


public  String  get IndentToken ( )  { 

return  this ._indentToken; 

} 

protected  void  set IndentToken (String  token)  { 
this . _indentToken  =  token; 
this ._indentTokenLen  =  token . length () ; 

} 

public  String  toStringO  { 
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return  this ._indent . toString ( )  ; 

} 


15.  TranslationMap.java 

package  mil. navy . nps . cs . oomi . translator ; 

import  java. util.*; 

/** 

*  Keeps  a  mapping  of  attributes  between  two  classes. 

*/ 

public  class  TranslationMap  { 

/** 

*  The  name  of  the  source  class . 

*/ 

protected  String  _sourceClassName; 

/** 

*  The  name  of  the  target  class . 

*/ 

protected  String  _targetClassName; 

/** 

*  The  attribute  mappings. 

*/ 

protected  List  _mappingList  =  new  LinkedList ( ) ; 

/** 

*  Creates  a  new  instance  of  mapping  from  attributes  of  sourceClass  to 

*  attributes  of  targetClass. 

*/ 

public  TranslationMap (  String  sourceClassName,  String  targetClassName  )  ( 

this ._sourceClassName  =  sourceClassName; 
this ._targetClassName  =  targetClassName; 

} 


/** 

*  Adds  an  attribute  mapping. 
*/ 
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public  void  add (  TranslationAttributeMapping  mapping  )  { 


_mappingList . add (mapping) ; 

} 


// - 

//  Accessors 
// - 

/** 

*  Returns  null  if  no  mapping  defined. 

*/ 

public  TranslationAttributeMapping [ ]  getMappings ( )  { 

if  (_mappingList . isEmpty ( ) ) 
return  null; 
else 

return  (TranslationAttributeMapping [ ] ) _mappingList . toArray ( 

new  TranslationAttributeMapping [_mappingList . size ( ) ] ) 


/** 

*  Returns  the  number  of  mappings  defined. 
*/ 

public  int  getCountO  { 

return  _mappingList . size ( )  ; 


/** 

*  Returns  the  mapping  at  index  idx. 

*/ 

public  TranslationAttributeMapping  get (int  idx)  { 

return  (TranslationAttributeMapping)  _mappingList . get (idx) ; 


/** 

*  Removes  the  given  i-th  mapping. 
*/ 

public  void  remove (int  i)  { 
_mappingList . remove (i)  ; 


/** 

*  Removes  the  mappings  at  the  given  indices . 

*  If  indices==null ,  nothing  is  done. 

*/ 

public  void  remove (int []  indices)  { 
if  (indices==null) 
return; 
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int [ ]  sorted  =  new  int [ indices . length] ; 

System. arraycopy (  indices,  0,  sorted,  0,  indices . length  ); 
Arrays . sort ( sorted) ;  //  inascending  order 
for  (int  i=sorted. length-1;  i>=0;  i — )  { 

remove (indices [i] ) ; 


public  String  getSourceClassName ( )  { 

return  _sourceClassName; 

} 

public  String  getTargetClassName ( )  { 

return  _targetClassName; 

} 


16.  T  ranslationMapT  ableModel.  j  ava 

package  mil . navy . nps . cs . oomi . translator; 

import  javax . swing . table . * ; 
import  java . util . Arrays ; 

/** 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  TranslationMapTableModel  extends  AbstractTableModel  { 

/** 

*  Separator  for  attribute  path  when  displayed  in  the  table. 

*/ 

static  final  String  PATH_SEP  = 

protected  TranslationMap  _map; 

protected  final  int  FROM_COL  =  0; 
protected  final  int  TO_COL  =  1; 

public  TranslationMapTableModel (TranslationMap  map)  { 
super ( ) ; 
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this._map  =  map; 


public  int  getColumnCount ( )  { 

/**@todo:  implement  this  javax . swing . table . AbstractTableModel  abstract  method*/ 
return  2; 

} 

public  Object  getValueAt (int  row,  int  col)  { 

/**@todo:  implement  this  javax . swing . table .AbstractTableModel  abstract  method*/ 
Translat ionAttributeMapping  mapping  =  _map . get (row) ; 
switch  (col)  { 

case  FROM_COL:  return  mapping . sourceAttributesAsString ( 

PATH_SEP ,  false,  false); 

case  TO_COL:  return  mapping. getTargetAttribute () .path (false, PATH_SEP) ; 

} 

return  null; 

} 

public  int  getRowCount ( )  { 

/**@todo:  implement  this  javax . swing . table .AbstractTableModel  abstract  method*/ 
return  _map . get Count ()  ; 

} 

public  String  getColumnName (int  columnlndex)  { 
switch  (columnlndex)  { 

case  FROM_COL  :  return  _map . getSourceClassName ( ) ; 
case  TO_COL  :  return  _map . getTargetClassName ( ) ; 

} 

return  null; 

} 

public  void  add (  TranslationAttributeMapping  newMapping  )  { 

_map . add (newMapping) ; 

f ireTableRowsInserted (_map . getCount ( ) ,  _map . getCount ( ) ) ; 

} 

public  void  remove (  int  i  )  { 

_map . remove ( i ) ; 
f ireTableRowsDeleted (i,  i)  ; 


/** 

*  Removes  the  given  rows . 

*  If  rows==null,  nothing  is  done. 

*/ 

public  void  remove (  int [ ]  rows  )  { 

int [ ]  sorted  =  new  int [rows . length] ; 

System. arraycopy (  rows,  0,  sorted,  0,  rows. length  ); 
Arrays . sort ( sorted) ;  //  in  ascending  order 
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for  (int  i=sorted . length-1 ;  i>=0;  i — )  { 

remove (sorted [i]  )  ; 

fireTableRowsDeleted (sorted [ i ] ,  sorted[i] ) ; 


17.  ZzzT  est_T  ranslation  Attribute,  j  ava 

package  mil . navy . nps . cs . oomi . translator; 

import  junit . framework . TestCase; 
import  java. util.*; 

public  class  ZzzTest_TranslationAttribute  extends  TestCase 

{ 


public  ZzzTest_TranslationAttribute (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_Attribute (String  Name_) 

protected  void  setup () 

{ 

}  //protected  void  setup () 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_TranslationAttribute . class . getName ()} ; 
junit . swingui . TestRunner .main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

public  void  test_l()  { 

Translat ionAttribute  a  =  new  TranslationAttribute (  "int",  "attribute_a"  ); 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a,  "float",  "attribute_a_l 
assertEquals (  a,  a_l . getParent ( )  ); 

} 

public  void  test_2()  { 
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TranslationAttribute  a  =  new  TranslationAttribute (  "int" 
assertEquals (  null,  a . getParent ( ) ) ; 

} 

public  void  test_3()  { 

TranslationAttribute  a  =  new  TranslationAttribute  (  "int" 
assertEquals (  " . getAttribute_a ( ) " ,  a . readPath (true) ) ; 

} 

public  void  test_4()  { 

TranslationAttribute  a  =  new  TranslationAttribute (  "int" 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a, 
assertEquals (  " . getAttribute_a ( ) . getAttribute_a_l ( ) "  , 
a_l . readPath (true)  ); 


public  void  test_5()  { 

TranslationAttribute  a  =  new  TranslationAttribute (  "int" 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a, 
assertEquals (  " . getAttribute_a_l ( ) "  , 
a_l . readPath (false)  ); 


public  void  test_6()  { 

TranslationAttribute  a  =  new  TranslationAttribute (  "int" 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a, 
assertEquals (  " . getAttribute_a ( ) . setAttribute_a_l ( 1234 ) " 
a_l . writePath (true,  "1234")  ); 


public  void  test_7()  { 

TranslationAttribute  a  =  new  TranslationAttribute (  "int" 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a, 
assertEquals (  " . setAttribute_a_l ( 1234 ) "  , 

a_l . writePath (false,  "1234")  ); 


public  void  test_8()  { 

TranslationAttribute  a  =  new  TranslationAttribute (  "int" 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a, 
assertEquals (  "attribute_a_l "  , 

a_l .path (false,  "/")  ); 


public  void  test_9()  { 

TranslationAttribute  a  =  new  TranslationAttribute (  "int", 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a, 
assertEquals (  "attribute_a/attribute_a_l "  , 
a_l .path (true,  "/")  ); 


"attribute_a"  )  ; 


"attribute_a"  )  ; 


"attribute_a"  ) ; 

float",  "attribute_a_l "  )  ; 


"attribute_a"  )  ; 

float",  "attribute_a_l "  ); 


"attribute_a"  )  ; 

float",  "attribute_a_l "  ); 


"attribute_a"  ) ; 

float",  "attribute_a_l "  ); 


"attribute_a"  )  ; 

float",  "attribute_a_l "  )  ; 


"attribute_a"  )  ; 

float",  "attribute_a_l "  ); 
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public  void  test_pathToArray_l ( )  { 

Translat ionAttribute  a  =  new  TranslationAttribute (  "int",  "attribute_a"  ); 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a,  "float",  "attribute_a_l "  ); 
TranslationAttribute  a_l_l  =  new  TranslationAttribute (  a_l,  "float",  "attribute_a_2 "  ) 
TranslationAttribute [ ]  arr  =  {  a,  a_l,  a_l_l  }; 

assertTrue (  java . util .Arrays . equals (  arr,  a_l_l .pathToArray ( )  )  ); 


public  void  test_pathToArray_2 ( )  { 

TranslationAttribute  a  =  new  TranslationAttribute (  "int",  "attribute_a"  ); 
TranslationAttribute  a_l  =  new  TranslationAttribute (  a,  "float",  "attribute_a_l "  ); 
TranslationAttribute  a_l_l  =  new  TranslationAttribute (  a_l,  "float",  "attribute_a_2 "  ) 
TranslationAttribute [ ]  arrl  =  {  a  }; 

TranslationAttribute [ ]  arr2  =  {  a,  a_l  }; 
assertTrue (  Arrays . equals (  arrl,  a .pathToArray ( )  ) 

&&  Arrays . equals (  arr2,  a_l .pathToArray () )  ); 


}  //public  class  ZzzTest_TranslationAttribute  extends  TestCase 

18.  ZzzT  est_T  ranslationClassDefinition.j  ava 

package  mil . navy . nps . cs . oomi . translator; 

import  java. util.*; 

import  junit . framework . TestCase; 

import  mil . navy . nps . cs . oomi . f iom. FCRInstance; 

import  mil . navy . nps . cs . oomi . f iom. CCRInstance; 

public  class  ZzzTest_TranslationClassDef inition  extends  TestCase 

{ 


public  ZzzTest_TranslationClassDef inition (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_TranslationClassDef inition (String  Name_) 

protected  void  setup () 

{ 

}  //protected  void  setup () 

protected  void  tearDown () 

{ 
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}  //protected  void  tearDown () 


public  static  void  main (String [ ]  args) 

{ 

String[]  testCaseName  =  { ZzzTest_TranslationClassDef inition . class . getName ()} ; 
junit . swingui . TestRunner .main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

public  String  stripWhiteSpace (String  s)  { 
return  StringHelper . stripAll (  s,  "  \t\n"  ); 


/** 

*  One-level 
*/ 

public  void  test_attribute_creation_code_lA ( )  { 

TranslationAttribute  a 

=  new  TranslationAttribute (  null,  FCRInstance_l . class,  "a",  true  ); 

TranslationAttribute  a_f 

=  new  TranslationAttribute (  a,  FCRInstance_l_l . class,  "f",  true  ); 

TranslationAttribute  a_f_ff 

=  new  TranslationAttribute (  a_f,  FCRInstance_l_l_l . class,  "ff",  true  ); 
TranslationAttribute  a_f_il 

=  new  TranslationAttribute (  a_f,  int. class,  "il",  true  ); 

Trans lationClassDef inition .At tributeP arent All ocationCodeGener at or 

generator  =  new  TranslationClassDef inition . AttributeParentAllocationCodeGenerator () ; 
generator . generate (a_f_il ) ; 

String []  expected  =  {  "result . setF (new 

mil . navy . nps . cs . oomi . translator . FCRInstance_l_l ( ) ) ; "  } ; 

String[]  lines  =  (StringH)  generator .  code  ( )  .  toArray  (new  String  [generator .  code  ().  size  ()])  ; 

assertTrue  (  Arrays . equals (expected, lines)  ); 


/** 

*  One-level 
*/ 

public  void  test_attribute_creation_code_lB ( )  { 

TranslationAttribute  a 

=  new  TranslationAttribute (  null,  FCRInstance_l . class,  "a",  true  ); 
TranslationAttribute  a_l 

=  new  TranslationAttribute (  a,  FCRInstance_l_l . class,  "f" ,  true  ); 
TranslationAttribute  a_l_l 

=  new  TranslationAttribute (  a_l,  FCRInstance_l_l_l . class,  "ff",  true  ); 
TranslationClassDef inition .At tributeP arent All ocationCodeGener at or 

generator  =  new  TranslationClassDef inition . AttributeParentAllocationCodeGenerator () ; 
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generator . generate  (a_l_l ) ; 

String []  expected  =  {  "result . setF (new 

mil . navy . nps . cs . oomi . translator . FCRInstance_l_l ( ) ) ; "  } ; 

String  []  lines  =  (String  [])  generator .  code  ( )  .  toArray  (new  String  [generator .  code  ().  size  ()])  ; 

assertTrue (  Arrays . equals (expected, lines)  ); 

} 

/** 

*  Two-levels. 

*/ 

public  void  test_attribute_creation_code_two_levels_l ( )  { 

TranslationAttribute  a 

=  new  TranslationAttribute (  null,  FCRInstance_l . class,  "a",  true  ); 

TranslationAttribute  a_f 

=  new  TranslationAttribute (  a,  FCRInstance_l_l . class,  "f",  true  ); 

TranslationAttribute  a_f_ff 

=  new  TranslationAttribute (  a_f,  FCRInstance_l_l_l . class,  "ff",  true  ); 
TranslationAttribute  a_f_ff_il 

=  new  TranslationAttribute (  a_f_ff,  int. class,  "il",  true  ); 

TranslationAttribute  a_f_ff_fl 

=  new  TranslationAttribute (  a_f_ff,  float. class,  "fl",  true  ); 

Trans 1 at ionClassDef init ion . AttributeParentAllocationCodeGenerator 

generator  =  new  TranslationClassDef inition . AttributeParentAllocationCodeGenerator ( ) ; 
generator . generate (a_f_f f_il ) ; 
generator . generate (a_f_ff_fl ) ; 

//assertEquals (  stripWhiteSpace ( "abc  d\ne  f"),  stripWhiteSpace ( "a  \tbcdef")  ); 

String[]  lines  =  (StringH)  generator .  code  ().  toArray  (new  String  [generator .  code  ().  size  ()])  ; 
String []  expected  =  new  String []  { 

" result . set F (new  mil . navy . nps . cs . oomi . translator . FCRInstance_l_l ());", 

"result . getF ( )  . setFf (new  mil . navy . nps . cs . oomi .translator . FCRInstance_l_l_l ( ) )  ;  " 

} ; 

assertTrue (  Arrays . equals (expected,  lines)  ); 

} 

/** 

*  Two-levels. 

*/ 

public  void  test_attribute_creation_code_two_levels_2 ( )  { 

TranslationAttribute  a 

=  new  TranslationAttribute (  null,  FCRInstance_l . class,  "a",  true  ); 

TranslationAttribute  a_f 

=  new  TranslationAttribute (  a,  FCRInstance_l_l . class,  "f",  true  ); 

TranslationAttribute  a_f_dl 

=  new  TranslationAttribute (  a_f,  double . class,  "dl",  true  ); 

TranslationAttribute  a_f_ff 
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=  new  TranslationAttribute (  a_f,  FCRInstance_l_l_l . class,  "ff",  true  ); 
TranslationAttribute  a_f_ff_il 

=  new  TranslationAttribute (  a_f_ff,  int. class,  "il",  true  ); 

TranslationAttribute  a_f_ff_fl 

=  new  TranslationAttribute (  a_f_ff,  float. class,  "fl",  true  ); 

Trans lationClassDef ini t ion . AttributeParentAllocationCodeGenerator 

generator  =  new  TranslationClassDef inition . AttributeParentAllocationCodeGenerator ( ) ; 
generator . generate (a_f_ff_il)  ; 
generator . generate (a_f_f f_f 1)  ; 
generator . generate (a_f_dl ) ; 

String[]  lines  =  (String[])  generator . code (). toArray (new  String [generator . code (). size ()]) ; 
String []  expected  =  new  String []  { 

"result . setF (new  mil . navy . nps . cs . oomi . translator . FCRInstance_l_l ());", 

"result . getF ( ) . setFf (new  mil . navy . nps . cs . oomi .translator . FCRInstance_l_l_l ( ) ) ; " 

}; 

assertTrue  (  Arrays . equals (expected,  lines)  ); 


}  //public  class  ZzzTest_TranslationClassDef inition  extends  TestCase 

class  FCRInstance_l  extends  FCRInstance  { 

FCRInstance_l_l  f; 

} 

class  FCRInstance_l_l  extends  FCRInstance  { 
int  il; 
double  dl; 

FCRInstance_l_l_l  ff; 

} 

class  FCRInstance_l_l_l  extends  FCRInstance  { 
int  il; 
float  fl; 

} 

19.  ZzzT  est_T  r  anslationF  actory.j  ava 

package  mil . navy . nps . cs . oomi . translator; 

import  junit . framework . TestCase; 
import  java . util . Arrays ; 

import  mil . navy . nps . cs . oomi . exceptions . IntrospectionException; 

public  class  ZzzTest_TranslationFactory  extends  TestCase 
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{ 


public  ZzzTest_TranslationFactory (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_TranslatorFactory (String  Name_) 

protected  void  setup () 

{ 

}  //protected  void  setup () 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_TranslationFactory . class . getName () } 
junit . swingui . Test Runner . main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 

public  void  testExtractAttributes ( )  throws  IntrospectionException  { 
TranslationAttribute [ ] 

oracle  =  {new  TranslationAttribute (" java . lang . String" ,  "stringl"), 

new  Translat ionAttribute (" java . lang . String" ,  "string2")  }; 
assertTrue (  Arrays . equals ( 

TranslationAttribute . extractAttributes ( 

null, 

TestAttributeExtraction . class) 

oracle) 

)  ; 


public  void  testParseClassName_l ( )  { 

ParsedClassName  c  =  ParsedClassName .parseClassName ( "a .b . c" ) ; 
assertEquals (  "c",  c.className ()  ); 

} 

public  void  testParseClassName_2 ( )  { 

ParsedClassName  c  =  ParsedClassName .parseClassName ( "a .b . c" ) ; 
assertEquals (  "a.b",  c . packageName ( )  ); 

} 

public  void  testParseClassName_3 ( )  { 

ParsedClassName  c  =  ParsedClassName .parseClassName ( "c" ) ; 
assertEquals (  c . packageName ( )  ); 
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} 

public  void  testParseClassName_4 ( )  { 

ParsedClassName  c  =  ParsedClassName .parseClassName ( "c" ) ; 
assertEquals (  "c",  c.className ()  ); 

} 

public  void  testParseClassName_5 ( )  { 

ParsedClassName  c  =  ParsedClassName .parseClassName ; 

assertTrue  (  c . className (). equals ("" )  &&  c .packageName (). equals ("" )  ); 

} 

}  //public  class  ZzzTest_TranslationFactory  extends  TestCase 

class  TestAttributeExtraction  { 

private  String  getAString()  {  return  null;  } 
public  String  getStringl()  {  return  null;  } 
public  String  aString()  {return  null;} 
public  String  getString2()  {  return  null;  }; 


B.  PACKAGE:  mil.navy.nps.cs.babel.plugin 

1.  CodeGeneratedE  vent,  java 

package  mil . navy . nps . cs . babel . plugin; 

import  java . io . File; 

import  java . util . EventObject; 

/** 

*  This  event  signals  that  code  had  been  generated  from  the 

*  translation  generator. 

*/ 

public  class  CodeGeneratedEvent  extends  EventObject  { 

/** 

*  The  source  code  generated. 

*/ 

private  String  _sourceCode  = 
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/** 

*  The  package  name  of  the  generated  code. 

*/ 

private  String  _packageName  =  " 

/** 

*  The  relative  file  path  for  the  generated  code's  file. 

*/ 

private  File  _javaFile  =  null; 

/** 

*  The  class  name  of  the  generated  translation. 

*/ 

private  String  _className  = 

public  CodeGeneratedEvent (Object  source. 

String  packageName,  String  className, 
String  sourceCode, 

File  javaFile)  { 

super (source) ; 

this ._className  =  className; 
this ._packageName  =  packageName; 
this ._sourceCode  =  sourceCode; 
this ._javaFile  =  javaFile; 


/** 

*  Returns  the  source  code  generated. 
*/ 

public  String  getSourceCode ( )  { 

return  _sourceCode; 


/** 

*  Returns  the  package  name  of  the  generated  code. 
*/ 

public  String  getPackageName ( )  { 

return  _packageName; 

}; 


/** 

*  Returns  the  class  name  of  the  generated  translation. 
*/ 

public  String  getClassName ( )  { 
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return  _className; 


} ; 

/** 

*  Returns  the  file  path  (relative)  that  the  Java  file  to  contain  generated  code. 

*  For  example,  for  generated  code  whose  main  class  is  "pi .p2 . ClassA" , 

*  the  relative  path  will  be  "pl/p2/ClassA. java"  or  "pl\p2\ClassA. java" , 

*  depending  on  the  OS . 

*/ 

public  File  get JavaFile ( )  { 

return  _javaFile; 

} 


2.  CodeGenerationListener.java 

package  mil . navy . nps . cs . babel . plugin; 

import  java . util . EventListener; 

/** 

*  A  plugin  for  the  Translation  Generator  to  interface  with  the  Babel  IDE. 
*/ 

public  interface  CodeGenerationListener 

extends  EventListener  { 


/** 

*  Called  by  the  TranslationGeneratorPlugin  when  code  is  generated. 

*  @param  event  The  event  generated,  contains  information  on 

*  the  code  generated,  its  package  name,  class  name  and  the 

*  relative  path  of  the  Java  file  for  the  generated  code. 

*  @see  CodeGeneratedEvent 
*/ 

public  void  codeGenerated (  CodeGeneratedEvent  event  ); 


3.  T  ranslationGeneratorPlugin.j  ava 

package  mil . navy . nps . cs . babel . plugin; 


import  java . awt . Container ; 


I  ★  ★ 
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*  A  plugin  for  the  Translation  Generator  to  interface  with  the  Babel  IDE. 

*/ 

public  interface  TranslationGeneratorPlugin  { 

/** 

*  Returns  the  container  that  this  object  is  being  displayed  in. 

*  Sreturn  Returns  the  Container  object  that  the  UI  components  of  this  object 

*  is  displayed  in. 

*/ 

public  Container  getContentPane ( )  ; 

/** 

*  Adds  the  code  generation  listener. 

*/ 

public  void  addCodeGenerationListener (  CodeGenerationListener  listener  ) ; 

/** 

*  Removes  the  specified  CodeGenerationListener. 

*/ 

public  void  removeCodeGenerationListener (  CodeGenerationListener  listener  ) ; 
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APPENDIX  C.  TRANSLATOR  SOURCE  CODE 


A.  PACKAGE:  mil.navy.nps.cs.oomi.translator 

1.  Translator,  java 

package  mil . navy . nps . cs . oomi . translator; 

import  java . net . URL; 
import  java . io . Input Stream; 
import  java . io . OutputStream; 
import  java . io . OutputStreamWriter; 
import  java . io . Input St reamReader; 
import  java. util.*; 

import  java . lang . reflect . InvocationTargetException; 

import  mil . navy . nps . cs . oomi . f iom. *; 
import  mil . navy . nps . cs . oomi . exceptions . * ; 


/** 

*  The  OOMI  translator. 

*  The  translator  uses  one  specific  instance  of  a  FIOM. 

*  <p> 

*  Typical  translation  scenario: 

*  <img  src="doc-f iles/Translator_usage_scenario_seq. gif "> 

*  ©author  LSC 

*  ©version  1 . 0 
*/ 

public  class  Translator  { 

/** 

*  The  Federation  that  this  Translator  is  operating  on. 
*/ 

protected  FIOM  _fiom  =  null; 
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/** 

*  Creates  a  translator  that  operates  on  the  specified  federation  (fiom) . 
*/ 

public  Translator (  FIOM  fiom  )  { 

setFIOM ( f iom) ; 

} 


public  FIOM  getFIOM ( )  { 

return  _fiom; 


public  void  setFIOM (FIOM  fiom)  { 
_fiom  =  fiom; 

} 


/** 

*  Translates  the  given  CCRSchema  instance  into  its  corresponding 

*  FCRSchema  instance. 

public  FCRSchema  toFCRInstance  (  CCRSchema  ccrlnstance  )  { 

return  null; 

} 

*/ 


/** 

*  Translates  the  given  FCRSchema  instance  into  its  corresponding 

*  CCRSchema  instance. 

public  CCRSchema  toCCRInstance  (  FCRSchema  fcrlnstance. 

String  destinationSystem  )  { 

return  null; 

} 

*/ 


/** 

*  Translates  the  given  CCRSchema  instance  into  a  FCRSchema  instance 

*  for  the  given  targetSystem. 

*  ©return  A  FCRSchema  instance  translated  from  the  given  CCRSchema  instance, 
public  FCRSchema  toDestinationFCRInstance  (  FCRSchema  fcrlnstance. 

String  destinationSystem  )  { 

return  null; 

} 

*/ 
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/** 

*  Creates  the  TranslatorSourcelnf o  object  based  on  the  specified  information. 

*  @param  systemName  The  source  system  name. 

*  @param  xmlNameSpaceURI  The  namespace  URI  for  the  source  XML  document. 

*  Generally,  this  information  should  be  present  in 

*  the  XML  document  received  or  can  be  supplied  by  the 

*  sender  in  the  communication  protocol. 

*  @param  xmlStream  The  input  stream  supplying  the  source 

*  XML  document  content . 

*  ©return  An  instance  of  TranslatorSourcelnf o . 

*  ©throws  UnknownNameSpaceURIException  When  the  specified  URI  is  not  known 

*  to  the  current  Federation  (FIOM) . 

*/ 

public  TranslatorSourcelnf o  createSourcelnf o (  String  systemName, 

URL  xmlNameSpaceURI, 

InputStream  xmlStream  ) 
throws  UnknownNameSpaceURIException, 
UnmarshalException, 
ClassNotFoundException, 

Inst ant iationExcept ion, 
IllegalAccessException  { 

TranslatorSourcelnf o  result  =  new  TranslatorSourcelnf o (systemName) ; 

CCR  ccr  =  getFIOM ( ) . f indCCR (  systemName,  xmlNameSpaceURI  ); 
if  (ccr  ==  null) 

throw  new  UnknownNameSpaceURIException (xmlNameSpaceURI ) ; 

FCR  fcr  =  ccr . getFCR ( ) ; 

//  Load  the  OCR's  Java  class  for  unmarshalling. 

Class  ccrClass  =  Class . forName (  ccr . get JavaClassName ( )  ); 

//  Calls  the  unmarshaller . 

CCRInstance  ccrlnstance  =  CCRInstance . unmarshal (  ccrClass,  xmlStream  ); 

AbstractTranslat ion  translation 

=  f indTranslation (  Class . forName (fcr . get JavaClassName ()) , 
ccrClass  ) ; 

result . setCCR (ccr) ; 

result . setCCRInstance (ccrlnstance) ; 

result . setFCRInstance (  translation . toFCR (ccrlnstance)  ); 
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return  result; 


}  //  createSourcelnfo (String,  URL) 


/  -k  -k 


*  Transforms  the  specified  fcrlnstance  into  its  CCRInstance  of  the 

*  specified  CCR. 

*/ 


public  CCRInstance  toCCRInstance (  CCR  ccr, 

FCRInstance  fcrlnstance  ) 
throws  ClassNotFoundException, 
IllegalAccessException, 
InstantiationException  { 
Class  ccrlnstanceClass  =  Class . forName (ccr . get JavaClassName ()) ; 
AbstractTranslation  translation 

=  f indTranslation (  fcrlnstance . getClass () , 
ccrlnstanceClass  ) ; 

CCRInstance  ccrlnstance  =  translation . toCCR (fcrlnstance) ; 


return  ccrlnstance; 

} 


/** 

*  Finds  the  Translation  for  the  specified  FCR  and  CCR. 

*/ 

public  AbstractTranslation  f indTranslation (  Class  fcrlnstanceClass, 

Class  ccrlnstanceClass  ) 
throws  ClassNotFoundException, 
IllegalAccessException, 
InstantiationException  { 

String  className  =  getFIOM (). f indTranslation ( 

fcrlnstanceClass . getName ( ) , 
ccrlnstanceClass . getName ( )  ); 

AbstractTranslation  result 

=  (AbstractTranslation)  (  Class . forName (  className  ) . newlnstance ( )  ) 

return  result; 

} 


/** 

*  Finds  the  possible  destinations  for  the  given  TranslatorSourcelnf o . 

*  @param  source 

*  @param  destinationSystem  The  destination  system. 

*  @return  Returns  an  array  of  CCR  that  are  suitable  destinations  based 
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*  on  the  given  source  and  destinationSystem .  The  array  is  sorted 

*  from  least  suitable  (element  0)  to  most  suitable  (last  element) . 

*  Suitability  is  defined  as  the  count  of  the  number  optional 

*  attributes  satisfied  by  the  source's  FCR  instance. 

*/ 

public  CCR [ ]  findDestinations (  TranslatorSourcelnf o  source. 

String  destinationSystem  ) 
throws  InvocationTargetException, 

I 1 legal Ac cess Except ion, 

java . beans . IntrospectionException, 

NoSuchMethodException  { 

FCR  srcFCR  =  source . getFCR () ; 

FEV  fev  =  srcFCR. getFEV ( ) ; 

FE  fe  =  fev.getFEO; 

/* 

mil . navy . nps . cs . oomi . fiom. Attribute [ ]  mandat oryAttrs 
=  source . getCCR ( )  . mandatoryFCRAttributes  ( ) ; 
int  mandatoryCount  =  mandatoryAttrs . length; 

*/ 

List  candidates 

=  new  ArrayList (  Arrays . asList ( fe . findCCR (  destinationSystem  )  )  ); 

Listlterator  iter  =  candidates . listlterator  () ; 

String  attrNames[]; 

Attributed  srcFCRAttrs  =  srcFCR .  getFCRSchema  ().  enumerateAttributes  ()  ; 

List  matchCounts  =  new  ArrayList (10) ; 
while  (iter .hasNext () )  { 

CCR  dstCCR  =  (CCR) iter .next () ; 

MatchCount  count  =  attributeMatchCount (  source,  dstCCR  ) ; 
if  (count . mandatorySatisf ied () ) 
matchCounts . add  (count ) ; 

) 

MatchCount [ ]  sortedCounts 

=  (MatchCount!])  matchCounts . toArray (new  MatchCount [matchCounts . size  ()] ) 
Arrays . sort (  sortedCounts  ); 

CCR [ ]  result  =  new  CCR [sortedCounts . length] ; 
for  (int  i=0;  i<sortedCounts . length;  it+)  ( 
result [i]  =  sortedCounts  [ i]  . getCCR () ; 

) 

return  result; 
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*  A  convenience  method  to  perform  a  one-step  translation  from 

*  the  source  XML  document  to  the  destination  XML  document. 

*  ©return  Returns  true  if  the  source  XML  document  is  successfully  translated 

*  to  the  destination  system. 

*  Returns  false  if  no  matching  destination  CCR  can  be  found. 

*/ 

public  boolean  translate (  String  sourceSystemName,  URL  sourceNamespaceURI , 

InputStream  sourceStream, 

String  destinationSystemName, 

OutputStream  destinationStream  ) 
throws  ClassNotFoundException, 

UnmarshalException, 

UnknownNameSpaceURIException, 
java . beans . IntrospectionException, 

IllegalAccessException, 

java . lang . InstantiationException, 

java . lang .reflect . I nvocationTarget Except ion, 

NoSuchMethodException, 

org . exolab .castor . xml . ValidationException, 
org . exolab .castor . xml . Marshal Except ion  { 

// —  Translates  into  the  source  FCRInstance 
TranslatorSourcelnf o  srclnfo  = 

createSourcelnfo  (  sourceSystemName,  sourceNamespaceURI,  sourceStream  ); 

// —  determine  the  possible  destination  OCRs 
// —  for  the  specified  destination  system 

CCR [ ]  destCCR  =  findDestinations (  srclnfo,  destinationSystemName  ); 
if  (destCCR. length==0) 
return  false; 

//  — 

FCRInstance  srcFCRInstance  =  srclnfo . getFCRInstance () ; 

// —  use  the  most  suitable  CCR 

CCR  targetCCR  =  destCCR [destCCR. length-1] ; 

//  — 

Abst ractTranslat ion  dstTranslation  = 

(Abstract Translation) 

Class . forName (getFIOM ( ) . f indTranslation (  targetCCR. getFCR ( ) . get JavaClassName ( ) , 

targetCCR. get JavaClassName ( )  )) . newlnstance ( ) ; 

// —  load  the  class  definition  for  the  target  FCRInstance 

Class  dstFCRInstanceClass  =  (Class) Class . forName (targetCCR. getFCR (). get JavaClassName () ) 
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// —  perform  a  shallow  copy  of  srcFCRInstance  into  a  new  object 
FCRInstance  dstFCRInstance 

=  FCRInstanceHelper . clone (  srclnf o . getFCRInstance ( ) ,  dstFCRInstanceClass  ); 
// —  final  translation 

CCRInstance  dstCCRInstance  =  dstTranslation . toCCR (  dstFCRInstance  ); 

// —  marshal  to  XML 

dstCCRInstance .marshal (  destinationStream  ); 

return  true; 


^  -k  -k 


Determines  the  mandatory  and  optional  attribute  match  count  of 
the  specified  dstFCR  to  that  of  the  srcFCR. 

@param  srcFCRInstance  The  source  FCR  instance. 

Sparam  dstCCR  The  possible  destination  CCR  to  match  against. 

^return  Returns  a  MatchCount  that  indicates  the  number  of  mandatory  and 
optional  attributes  of  dstFCR  that  matches  that  of  dstCCR. 


*/ 


static  MatchCount  attributeMatchCount (  TranslatorSourcelnf o  src, 

CCR  dstCCR  ) 

throws  InvocationTargetException, 

I 1 legal Ac cess Except ion, 

java . beans . IntrospectionException, 

NoSuchMethodException  ( 

MatchCount  count  =  new  MatchCount (dstCCR)  ; 

FCR  dstFCR  =  dstCCR. getFCRO  ; 


Attribute!]  attrArray  =  dstFCR . getFCRSchema (). enumerateAttributes ()  ; 
Attribute  attr; 

for  (int  i=0;  i<attrArray . length;  i++)  ( 

attr  =  attrArray [i] ; 
if  (src. hasAttribute (attr) )  ( 

if  (  src . hasValue (attr)  ) 

if  (dstCCR. isMandatoryFCRAttribute (attr) ) 
count . incMandatory ( )  ; 
else 

count . incOptional ( ) ; 


count . setMandatorySatisf ied ( 

count . getMandatoryMatchCount ( )  ==  dstCCR . mandatoryFCRAttributeCount ( )  ) 
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return  count; 


} 

public  static  void  p (String  msg)  { 
System. out .println (msg)  ; 

} 


/** 

*  A  class  to  hold  information  on  the  Source  required  for  translation. 
*/ 

class  TranslatorSourcelnfo  { 

String  _systemName  = 

CCR  _ccr  =  null; 

FCRInstance  _fcrlnstance  =  null; 

CCRInstance  _ccrlnstance  =  null; 

/** 

*  A  map  of  all  attributes,  including  all  descendent  attributes, 

*  with  the  full  path  of  the  attributes  as  the  key. 

V 

Map  _fcrAttributesMap  =  new  HashMapO; 

TranslatorSourcelnfo (  String  systemName  )  ( 

setSystemName (systemName)  ; 

} 


public  String  getSystemName ( )  ( 

return  _systemName; 

) 

public  void  setSystemName (String  systemName)  { 
_systemName  =  systemName; 

) 

public  FCR  getFCR ( )  { 

return  _ccr . getFCR ()  ; 

) 

public  CCR  getCCRO  { 
return  _ccr; 

} 

public  void  setCCR(CCR  ccr)  { 

_ccr  =  ccr; 

} 

public  FCRInstance  getFCRInstance ( )  ( 
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return  _f crlnstance; 


} 

public  void  setFCRInstance (FCRInstance  v)  { 
_fcrAttributesMap . clear ( )  ; 

_fcrlnstance  =  v; 

} 

public  CCRInstance  getCCRInstance ( )  ( 

return  _ccr Instance; 

} 

public  void  setCCRInstance (CCRInstance  v)  ( 
_ccrlnstance  =  v; 


/** 

*  Indicates  if  the  attribute  in  getFCRInstance ( )  has  any  value  set. 
*/ 

public  boolean  hasValue (Attribute  attr) 

throws  java . beans . IntrospectionException, 

I 1 legal Ac cess Except ion, 
InvocationTargetException, 
NoSuchMethodException  ( 

return  FCRInstanceHelper . hasValue (getFCRInstance () ,  attr); 


/** 

*  Returns  the  FCR  attribute  map. 
*/ 


Map  fcrAttributeMap ( )  { 

if  (_fcrAttributesMap . size ( ) ==0  &&  getFCR ( ) ! =null)  ( 

Attributed  attrArray  =  getFCR  ().  getFCRSchema  ().  enumerateAttributes  ( ) 
for  (int  i=0;  i<attrArray . length;  i++)  ( 

_f crAtt ributesMap . put (  attrArray [i] . fullPath () ,  attrArrayti]  ); 


return  _fcrAttributesMap; 


/** 

*  Indicates  if  the  source  FCR  has  the  specified  attribute. 
*/ 

public  boolean  hasAttribute (  Attribute  attr  )  ( 

return  fcrAttributeMap ( ) . containsKey (attr . fullPath ()) ; 

) 
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*  A  class  to  hold  information  on  mandatory  match  and  overall  match  counts. 
*/ 

class  MatchCount  implements  Comparable  { 

/** 

*  Number  of  mandatory  matches . 

*/ 

int  _mandatoryMatchCount=0 ; 

/'** 

*  Number  of  optional  matches. 

V 

int  _optionalMatchCount=0; 

/** 

*  Indicates  if  all  mandatory  attributes  had  been  satisfied. 

*/ 

boolean  _mandatorySatisf ied  =  false; 

/** 

*  The  CCR  that  this  MatchCount  is  based  on. 

V 

CCR  _ccr; 


public  MatchCount (  CCR  ccr  )  { 

_ccr  =  ccr; 

}; 


MatchCount (  CCR  ccr,  boolean  mandatorySatisf ied, 

int  mandatoryCount ,  int  optionalCount  )  ( 

_ccr  =  ccr; 

_mandatorySatisf ied  =  mandatorySatisf ied; 
_mandatoryMatchCount  =  mandatoryCount; 
_optionalMatchCount  =  optionalCount; 


/** 

*  Increase  mandatory  count  by  one. 
*/ 

public  void  incMandatory ( )  { 

_mandatoryMatchCount++ ; 


I  ~k  -k 
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*  Increase  optional  count  by  one. 

*/ 

public  void  incOptional ( )  { 

_opt ionalMatchCount++ ; 

} 

public  void  setMandatorySatisfied (  boolean  v  )  ( 

_mandatorySatisf ied  =  v; 

} 


public  int  getMandatoryMatchCount ( )  ( 

return  _mandatoryMatchCount ; 

} 

public  int  getOptionalMatchCount ( )  ( 

return  _optionalMatchCount ; 

} 

public  boolean  mandatorySatisfied ( )  ( 

return  _mandatorySatisf ied; 

} 

public  int  totalMatchCount ( )  { 

return  getMandatoryMatchCount ( )  +  getOptionalMatchCount () ; 

} 

public  CCR  getCCRO  { 
return  _ccr; 

} 

public  int  compareTo (Ob ject  obj)  ( 

MatchCount  c  =  (MatchCount ) ob j ; 

if  (getMandatoryMatchCount () ==c . getMandatoryMatchCount () )  ( 

if  (getOptionalMatchCount ( ) >c . getOptionalMatchCount ( ) ) 
return  1; 

else  if  (getOptionalMatchCount () <c . getOptionalMatchCount () ) 
return  -1; 
else 

return  0; 

} 

else  if  (getMandatoryMatchCount () >c . getMandatoryMatchCount () ) 
return  1; 

else  //  (getMandatoryMatchCount () <c . getMandatoryMatchCount () ) 
return  -1; 
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2. 


ZzzT  est_T  r  anslator.  j  ava 


package  mil . navy . nps . cs . oomi . translator; 


import  java . net . URL; 
import  java.io.*; 
import  java. util.*; 


import 

import 

import 

import 

import 

import 


junit . framework . TestCase; 

mil . navy . nps . cs . oomi . * ; 

mil . navy . nps . cs . oomi . impl . * ; 

mil . navy . nps . cs . oomi . f iom. * ; 

mil . navy . nps . cs . oomi . exceptions . * ; 

testclasses . * ; 


public  class  ZzzTest_Translator  extends  TestCase 

{ 


public  ZzzTest_Translator (String  Name_) 

{ 

super (Name_) ; 

}  //public  ZzzTest_Translator (String  Name_) 

OOMIDatabase  oomiDb  =  new  OOMIDatabaselmpl ( ) ; 

protected  void  setup () 

{ 

}  //protected  void  setup () 

protected  void  tearDown () 

{ 

}  //protected  void  tearDown () 

public  static  void  main (String [ ]  args) 

{ 

String []  testCaseName  =  { ZzzTest_Translator . class . getName () } 
junit . swingui . TestRunner .main (testCaseName) ; 

}  //public  static  void  main (String [ ]  args) 


public  static  void  p (String  msg)  { 
System. out . print In (msg) ; 

} 
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/** 

*  Builds  the  FIOM  for  testing  the  Translator. 

*  <pre> 

*  FE_1 

*  I  _  FE_1_1 

*  l_  FE_1_1_1 

*  I  _  FE_1_1_2 

*  FE_2 

*  I  _  FE_2_1 

*  I  _  FE_2_2 


*  FE_1 

*  | _  rootFEV_l_A 

*  I _  FEV_1_A_A 

*  I  _  FEV_1_A_B 

*  I _  FEV_1_A_C 


—  FCR_1_A 
—  FCR_1_A_A 
—  FCR_1_A_B 
—  FCR_1_A_C 


*  FCR_1_A 

*  |  _  ccr_l_A_l 

*  I  _  ccr_l_A_2 


*  FCR_1_A_A 

*  |  _  ccr_l_A_A_l 

*  l_  c c r_l_A_A_2 


*  </pre> 

*/ 

public  static  FIOM  createFIOMO (OOMIDatabase  oomiDb)  throws  Exception  { 
FIOM  fiom  =  oomiDb . newFIOM ( "FIOM  for  Testing"); 

FE  FE_1  =  f iom. newFE ( "FE_1 " ) ; 

FE  FE_1_1  =  FE_1 . newChild ( "FE_1_1 " ) ; 

FE  FE_1_1_1  =  FE_1_1  .newChild  ("FE_1_1_1")  ; 

FE  FE_1_1_2  =  FE_1_1  .newChild  ("FE_1_1_2")  ; 

FE  FE_2  =  fiom.  newFE  ("FE_2")  ; 

FE  FE_2_1  =  FE_1. newChild ( "FE_2_1" ) ; 

FE  FE_2_1_1  =  FE_1_1  .newChild  ("FE_2_1_1")  ; 

FE  FE_2_1_2  =  FE_1_1  .newChild  ("FE_2_1_2")  ; 
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FEV  rootFEV_l_A  =  FE_1 . createRootFEV ( " rootFEV_l_A" )  ;  FCR  FCR_1_A 

rootFEV_l_A. createFCR ( "FCR_1_A_A" ) ; 

FEV  FEV_1_A_A  =  rootFEV_l_A . newChild ( "FEV_1_A_A" ) ;  FCR  FCR_1_A_A 

FEV_1_A_A . createFCR ( "FCR_1_A_A" ) ; 

FEV  FEV_1_A_B  =  rootFEV_l_A . newChild ( "FEV_1_A_B" ) ;  FCR  FCR_1_A_B 

FEV_1_A_B . createFCR ( "FCR_1_A_A" )  ; 

FEV  FEV_1_A_C  =  rootFEV_l_A.  newChild  ("FEV_1_A_C")  ;  FCR  FCR_1_A_C 

FEV_1_A_C . createFCR ( "FCR_1_A_A" ) ; 


CCR  ccr_l_A_l  =  FCR_1_A . newCCR (  "System",  "CCR_1_A_1", 

new  URL ( "http : //localhost/testclasses/Address . xsd" )  ); 

CCR  ccr_l_A_2  =  FCR_1_A . newCCR (  "System",  "CCR_1_A_2", 

new  URL ( "http : //localhost/testclasses/Customer . xsd" )  ) 


CCR  c c r_l_A_A_l 


CCR  c c r_l_A_A_2 


FCR_1_A_A . newCCR ( 
new 

FCR_1_A_A . newCCR ( 
new 


"System",  "CCR_1_A_A_1 " , 

URL ( "http : / / localhost /test classes/ Invoice . xsd" ) 
"System",  "CCR_1_A_A_2 " , 

URL ( "http : / /localhost /test classes /Item. xsd" )  ) ; 


)  ; 


return  fiom; 

} 


/** 

*  Tests  :  Translator  (FIOM)  ,  getFIOMO,  setFIOM  (FIOM)  . 

*/ 

public  void  test_constructor_getsetFIOM_l ( )  throws  Exception  { 
FIOM  fiom  =  oomiDb . newFIOM ( "New  FiOm"); 

Translator  trans  =  new  Translator (  fiom  ); 
assertTrue  (  fiom  ==  trans . getFIOM ( )  ); 


/** 

*  Tests  the  conversion  of  a  XML  document  into  its  corresponding  FCRInstance. 

*/ 

public  void  test_createSourceInf o ( )  throws  Exception  { 

FIOM  fiom  =  oomiDb . newFIOM ( "New  FiOm"); 

Translator  trans  =  new  Translator (  fiom  ); 

String  sourceSystemName  =  "TheSource"; 

//URL  nsURI  =  new  URL (  "http://testing.123.com/"  ); 

URL  nsURI  =  new  URL (  (new  testclasses . InvoiceDescriptor ( ) ) . getNameSpaceURI ( )  ); 

fiom. addTranslation (  testclasses. Item. class . getName ( ) , 

testclasses. Invoice .class . getName ( ) , 
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CCR  ccr 


testclasses_Item _ testclasses_Invoice . class . getName ( )  ) ; 

=  f iom. newFE ( "FE" ) . newChild ( "Child" ) 

. createRootFEV ( "root  FEV") . createFCR ( " f cr " ) 

.newCCR(  sourceSystemName,  "CCR",  nsURI  ); 
ccr . set JavaClassName (  testclasses . Invoice . class . getName ( )  ); 

ccr . getFCR ( ) . set JavaClassName (  test classes. Item. class. getName ( )  ) ; 


String  xmlString  =  "<?xml  version=\ " 1 . 0\ " ?>"  + 

"< invoice  xmlns=\ "http : / / castor . exolab . or g/ Test / Invoice \ "xship- 

to><name>Ryan  Madden</name><address><streetl>2000  Alameda  de  las  Pulgasc/street l><city>San 
Mateo</city><state>CA</state><zip-code>94403</ zip-code></ addressxphone>650-345- 
2777</phone></ship-to><item  Id=\ " 0 . 9 . 3\ "  InStock=\ "true\ "  Category=\ "Open  Source 

Pro ject \ "><Quantity>l</Quantity><Price>100 . 00</Price></ i temx shipping- 

met  hod><carrier>UPS</  carrier><option>Ground  Trak</ option><estimated-delivery>PlD</ estimated- 

del  i  very  ></  shipping-methodxshipping-datexdate>2000-10- 
24</ date><time>12 : 30 : 00 . 0</time></ shipping-datex/ invoice>" ; 


ByteArrayOutputStream  out  =  new  ByteArrayOutputStream (5000) ; 
Writer  w  =  new  OutputStreamWriter (out ) ; 
w. write (xmlString)  ; 
w . flush ( ) ; 


Invoice  invoice  =  Invoice . unmarshal (new  InputStreamReader (  new 

ByteArraylnputStream (out . toByteArray ( ) )  ) ) ; 

String  category  =  invoice . getShippingMethod (). getCarrier () ; 

InputStream  in  =  new  ByteArraylnputStream (  out . toByteArray ( )  ); 

TranslatorSourcelnf o  srclnfo  = 

trans . createSourcelnf o (  sourceSystemName,  nsURI,  in  ); 

testclasses . Item  item  =  (testclasses . Item)  srclnfo . getFCRInstance () ; 


assertEquals (  "category:  "  +  category  ,  item. getCategory ( )  ); 

} 


public  void  test_MatchCount_compareTo ( )  { 


MatchCount 

cl  =  new 

MatchCount ( 

null. 

true. 

5, 

10 

MatchCount 

c2  =  new 

MatchCount ( 

null. 

true. 

5, 

10 

MatchCount 

c3  =  new 

MatchCount ( 

null. 

true. 

5, 

5 

MatchCount 

c4  =  new 

MatchCount ( 

null. 

true. 

5, 

15 

MatchCount 

assertlrue ( 

c5  =  new  MatchCount ( 

cl . compareTo (c2) ==0 

null, 

&& 

true. 

6, 

10 

cl . compareTo (c3) >0  && 


cl . compareTo (c4 ) <0  && 
cl . compareTo (c5) <0  ); 
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/** 

*  Builds  up  the  test  FIOM. 

*  The  FIOM  structure  is  shown  in  the  diagram  below: 

*  <img  src="doc-f iles/ZzzTest_Translator_sample_FIOM_l . gif "> 


*/ 

public  static  void  createTestFIOM (  FIOM  fiom  )  throws  DuplicateKeyException, 

UniqueNameViolationException, 
java . net .Malf ormedURLException  { 

FIOMFactory  f  =  fiom. factory () ; 

FE  entity_l  =  fiom.newFE(  "Entity_l"  ); 

FEV  entity_l_View_l  =  entity_l . createRootFEV (  "Entity_l_View_l "  ); 

FEV  entity_l_View_l_A  =  entity_l_View_l . newChild (  "Entity_l_View_l_A"  ); 

FEV  entity_l_View_l_B  =  entity_l_View_l . newChild (  "Entity_l_View_l_B"  ); 

FEV  entity_l_View_l_C  =  entity_l_View_l . newChild (  "Entity_l_View_l_C"  ); 

FCR  entity_l_View_l_f cr  =  entity_l_View_l . createFCR (  "Entity_l_View_l "  ); 

FCR  entity_l_View_l_A_f cr  =  entity_l_View_l_A. createFCR (  "Entity_l_View_l_A"  ); 

entity_l_View_l_A_f cr . set JavaClassName ( 
testclasses . FCR . Entity_l . ZZ_Entity_l_View_l_A. class .getName () ) ; 

FCR  entity_l_View_l_B_f cr  =  entity_l_View_l_B . createFCR (  "Entity_l_View_l_Bn  ); 

entity_l_View_l_B_f cr . set JavaClassName ( 
testclasses . FCR . Entity_l . ZZ_Entity_l_View_l_B . class . getName ( ) ) ; 

FCR  entity_l_View_l_C_f  cr  =  entity_l_View_l_C  .  createFCR  (  "Entity_l_View_l_C"  ); 

entity_l_View_l_C_f cr . set JavaClassName ( 
testclasses . FCR . Entity_l . ZZ_Entity_l_View_l_C . class . getName ( ) ) ; 

Attribute  attr; 

CCRImpl  entity_l_View_l_A_ccr 

=  (CCRImpl) ent it y_l_View_l_A_f cr . newCCR (  "SystemA",  "SystemA_l_View_l_A" , 

new  URL (  (new 

testclasses . CCR. SystemA_l_View_l_A. SystemAlViewlADescriptor ( ) )  . getNameSpaceURI ( ) )  )  ; 

entity_l_View_l_A_ccr . set JavaClassName ( 
testclasses . CCR. SystemA_l_View_l_A. SystemAlViewlA. class . getName ( )  ) ; 

Attribute  attrNameOfOb ject  =  f .makeAttribute (  null,  "NameOfOb ject " , 

f .makeTypeName (String. class)  ); 

attrNameOfOb ject . setMinOccurs (1); 

entity_l_View_l_A_ccr . getCCRSchema ( ) . addAttribute (  attrNameOfOb ject  ); 

Attribute  attrCreateTime  =  f .makeAttribute (  null,  "CreateTime" , 

f .makeTypeName (testclasses. CCR. SystemA_l_View_l_A. PST .class )  ) ; 

attrCreateTime . setMinOccurs (1)  ; 

ent ity_l_View_l_A_ccr . getCCRSchema ( ) . addAttribute (  attrCreateTime  ); 

CCRImpl  entity_l_View_l_B_ccr 
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=  (CCRImpl) entity_l_View_l_B_fcr . newCCR (  "SystemB",  "SystemB_l_View_l_B" , 

new 

URL ( "http : //nps . navy.mil/cs/oomi/ systemB/ SystemB_l_View_l_B" )  )  ; 

entity_l_View_l_B_ccr . set JavaClassName ( 
testclasses . CCR . SystemB_l_View_l_B . SystemBlViewlB . class . getName ( )  ) ; 

CCRImpl  entity_l_View_l_C_ccr 

=  (CCRImpl) ent it y_l_View_l_C_f cr . newCCR (  "SystemC",  "SystemC_l_View_l_C" , 

new 

URL ( "http : //nps . navy.mil/cs/oomi/ systemC/ SystemC_l_View_l_C" )  ) ; 

entity_l_View_l_C_ccr . set JavaClassName ( 
testclasses . CCR. SystemC_l_View_l_C . SystemCIViewlC . class . getName ( )  ) ; 

mil . navy . nps . cs . oomi . f iom. FCRSchema  f crSchema; 
mil . navy . nps . cs . oomi . f iom. CCRSchema  ccrSchema; 

f crSchema  =  entity_l_View_l_f cr . getFCRSchema ( ) ; 

fcrSchema. setType (f iom.makeTypeName (testclasses . FCR. Entity_l . ZZ_Entity_l_View_l .class) ) ; 
f crSchema . addAttribute (  new  Attributelmpl (null,  "Name", 

f iom.makeTypeName (String. class) )  ) ; 

fcrSchema . addAttribute (  new  Attributelmpl (null,  "Time", 

f iom.makeTypeName (testclasses. FCR. Entity_l . ZZ_UTC .class) ) ) ; 

fcrSchema  =  ent it y_l_View_l_A_f cr . getFCRSchema () ; 

fcrSchema. setType (f iom.makeTypeName (testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_A. class) ) 
fcrSchema . addAttribute (  new  Attributelmpl (null,  "Name", 

f iom.makeTypeName (String. class) ) ) ; 
fcrSchema . addAttribute (  new  Attributelmpl (null,  "Time", 

f iom.makeTypeName (testclasses .FCR. Entity_l . ZZ_UTC . class) ) ) ; 

fcrSchema . addAttribute (  new  Attributelmpl (null,  "String_l", 

f iom.makeTypeName (String .class) ) ) ; 
fcrSchema . addAttribute (  new  Attributelmpl (null,  "Integer_l", 

f iom.makeTypeName (Integer . TYPE) ) ) ; 
entity_l_View_l_A_ccr . addFCRToCCRAttributeMapping ( 
new  mil . navy . nps . cs . oomi . f iom . Attribute [ ] 

{  f .makeAttribute (null,  "Name", 

f iom.makeTypeName (String. class) )  } , 

attrNameOfOb ject  ) ; 

entity_l_View_l_A_ccr . addFCRToCCRAttributeMapping ( 
new  mil . navy . nps . cs . oomi . f iom . Attribute [ ] 

{  f .makeAttribute (null,  "Time", 

f iom.makeTypeName (testclasses . FCR.Entity_l . ZZ_UTC . class) ) 

}, 
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attrCreateTime  )  ; 


fcrSchema  =  entity_l_View_l_B_f cr . getFCRSchema ( )  ; 

fcrSchema. setType (f iom.makeTypeName (testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_B . class ) ) 
fcrSchema . addAttribute (  new  Attributelmpl (null,  "Name", 

f iom.makeTypeName (String .class)  )  )  ; 
fcrSchema . addAttribute (  new  Attributelmpl (null,  "Time", 

f iom.makeTypeName (testclasses . FCR. Entity_l . ZZ_UTC . class) ) )  ; 

fcrSchema . addAttribute (  new  Attributelmpl (null,  "String_l", 

f iom.makeTypeName (String . class)  )  )  ; 
fcrSchema . addAttribute (  new  Attributelmpl (null,  "String_l_B_l " , 

f iom.makeTypeName (String .class)  )  )  ; 
fcrSchema . addAttribute (  new  Attributelmpl (null,  "String_l_B_2 " , 

f iom.makeTypeName (String .class) ) ) ; 

CCRSchema  ent it y_l_View_l_B_ccr Schema  =  entity_l_View_l_B_ccr . getCCRSchema ( ) ; 

Attribute  attrBigName  =  entity_l_View_l_B_ccrSchema . addAttribute (  "BigName 
f .makeTypeName (String . class )  ); 

attrBigName . setMinOccurs ( 1 )  ; 

Attribute  attrTimeStamp  =  entity_l_View_l_B_ccrSchema . addAttribute (  "TimeStamp 
f .makeTypeName (Integer . TYPE)  ); 

attrTimeStamp . setMinOccurs ( 1 )  ; 

ent it y_l_View_l_B_ccr Schema . addAttribute (  "B_l",  f .makeTypeName (String . class)  ); 

ent ity_l_View_l_B_ccr Schema . addAttribute (  "String_l_Of_sysB 

f . makeTypeName ( String . class )  ); 

entity_l_View_l_B_ccr . addFCRToCCRAttributeMapping ( 

new  mil . navy . nps . cs . oomi . f iom . Attribute [ ] 

{  f .makeAttribute (null,  "Name", 

f iom.makeTypeName (String. class) )  } , 

attrBigName . copy ( )  ); 

entity_l_View_l_B_ccr . addFCRToCCRAttributeMapping ( 
new  mil . navy . nps . cs . oomi . f iom . Attribute [ ] 

{  f .makeAttribute (null,  "Time", 

f iom.makeTypeName (testclasses . FCR. Entity_l . ZZ_UTC . class) )  } , 

attrTimeStamp . copy ( )  ); 

fcrSchema  =  entity_l_View_l_C_f cr . getFCRSchema () ; 

fcrSchema . setType (f iom.makeTypeName (testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_C . class) ) 
fcrSchema . addAttribute (  "Name",  f iom.makeTypeName (String . class ) ) ; 

fcrSchema . addAttribute (  "Time",  f iom.makeTypeName (testclasses . FCR. Entity_l . ZZ_UTC . class ) ) 

fcrSchema . addAttribute (  " Integer_l_C_l " ,  f iom. makeTypeName (Integer . TYPE) ) ; 

CCRSchema  ent it y_l_View_l_C_ccr Schema  =  entity_l_View_l_C_ccr . getCCRSchema () ; 

Attribute  systemC_Name  =  entity_l_View_l_C_ccrSchema . addAttribute (  "Name 

f . makeTypeName ( String . class )  ); 

ent it y_l_View_l_C_ccr Schema . addAttribute (  "Time",  f .makeTypeName (String. class)  ); 
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entity_l_View_l_C_ccr . addFCRToCCRAttributeMapping ( 
new  mil . navy . nps . cs . oomi . f iom . Attribute [ ] 

{  f .makeAttribute (null,  "Name",  f iom. makeTypeName (String . class) )  }, 

systemC_Name . copy ( )  ) ; 

//  Register  the  translations 

f iom. addTranslation (  testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_A. class . getName ( ) , 

testclasses . CCR. SystemA_l_View_l_A. SystemAlViewlA. class . getName ( ) , 

testclasses . Translations . testclasses  FCR  Entity  1  ZZ  Entity  1  View  1  A  testclasses  CCR  System 
A_l_View_l_A_SystemAlViewlA. class . getName ( )  )  ; 

f iom. addTranslation (  testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_B . class . getName ( ) , 

testclasses . CCR. SystemB_l_View_l_B . SystemBlViewlB . class . getName ( ) , 

testclasses . Translations . testclasses_FCR_Entity_l_ZZ_Entity_l_View_l_B. _ _testclasses_CCR_System 

B_l_View_l_B_SystemBlViewlB . class . getName ( )  ) ; 

f iom. addTranslation (  testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_C . class . getName ( ) , 

testclasses . CCR. SystemC_l_View_l_C . SystemCIViewlC . class . getName ( ) , 

testclasses . Translations . testclasses_FCR_Entity_l_ZZ_Entity_l_View_l_C _ _testclasses_CCR_System 

C_l_View_l_C_SystemClViewlC . class . getName ( )  ) ; 

} 


/** 

*  Class  to  hold  test  data. 

*/ 

class  ZzzTestData_test_translationDetermination_l  { 

FIOM  fiom; 

CCR  targetCCR; 

testclasses . FCR . Entity_l . ZZ_Entity_l_View_l_A  srcFCRInstance; 
testclasses. CCR. SystemA_l_View_l_A. SystemAlViewlA  srcCCRInstance; 

FCRInstance  dstFCRInstance; 

CCRInstance  dstCCRInstance; 

CCR [ ]  destCCR; 

ZzzTestData_test_translationDetermination_l ( )  throws  Exception  { 
fiom  =  oomiDb . newFIOM ( "FIOM  1"); 
createTestFIOM (f iom) ; 

Translator  trans  =  new  Translator (  fiom  ); 

String  sourceSystemName  =  "SystemA"; 

URL  nsURI  =  new  URL  (  (new 

testclasses . CCR. SystemA_l__View_l_A. SystemAlViewlADescriptor ( ) ) . getNameSpaceURI ( ) ) ; 

String  xmlString  =  "<?xml  version=\ " 1 . 0\ " ?>" 

+  "<SystemA_l_View_l_A>" 

+  "  <NameOfOb ject>SystemA  Name</NameOfOb ject>" 

+  "  <PST> " 

+  "  <Month>01</Month>" 
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<Year>2001</Year> 


+  "  <Day>31</Day>" 

+  "  <Hour>01</Hour>" 

+  "  <Minute>59</Minute>" 

+  "  <Second>0 . 0</Second>" 

+  "  </PST>" 

+  "  <String_l_part_l>  part  1</String_l_part_l>" 

+  "  <String_l_part_2>  part  2</String_l_part_2>" 

+  "</SystemA_l_View_l_A>" 

ByteArrayOutputStream  out  =  new  ByteArrayOutputStream (5000) ; 

Writer  w  =  new  Output StreamWriter (out )  ; 
w. write (xmlString)  ; 
w . flush  ( ) ; 
srcCCRInstance 

=  testclasses . OCR. SystemA_l_View_l_A . SystemAlViewlA. unmarshal (new  InputStreamReader ( 
new  ByteArraylnputStream (out . toByteArray ( ) )  )); 

InputStream  in  =  new  ByteArraylnputStream (  out . toByteArray ( )  ); 

TranslatorSourcelnf o  srclnfo  = 

trans . createSourcelnf o (  sourceSystemName,  nsURI,  in  ); 

String  destSystem  =  "SystemB"; 

// —  determine  the  possible  destinations 

destCCR  =  trans . f indDestinations (  srclnfo,  destSystem  ); 

Arrays . sort (destCCR) ; 
srcFCRInstance 

=  (testclasses. FCR . Entity_l . ZZ_Entity_l_View_l_A)  srclnfo . getFCRInstance ( ) ; 
targetCCR  =  destCCR [destCCR. length-1 ]  ; 

AbstractTranslat ion  dstTranslation  = 

(Abstract Translation) 

Class . forName (f iom. f indTranslation (  targetCCR. getFCR ( ) . get JavaClassName ( ) , 

targetCCR. get JavaClassName ()  ) ) .newlnstance () ; 

// —  load  the  class  definition  for  the  target  FCRInstance 

Class  dstFCRInstanceClass  =  (Class) Class . forName (targetCCR. getFCR (). get JavaClassName ()) ; 
// —  perform  a  shallow  copy  of  srcFCRInstance  into  a  new  object 
dst FCRInstance 

=  FCRInstanceHelper . clone (  srclnfo . getFCRInstance () ,  dstFCRInstanceClass  ); 

// —  final  translation 
dstCCRInstance 

=  dstTranslation . toCCR (  dstFCRInstance  ); 
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/ 


*  Class  to  hold  test  data. 

*/ 

class  ZzzTestData_test_translate_l  { 

FIOM  fiom; 

InputStream  in; 

String  sourceSystemName; 

String  dest inat ionSystemName; 

URL  nsURI ; 

String  nameOfObject  =  "The  Name"; 

ZzzTestData_test_translate_l (  )  throws  Exception  { 
fiom  =  oomiDb . newFIOM ( "FIOM  1"); 
createTestFIOM (f iom) ; 
sourceSystemName  =  " SystemA"; 
dest inat ionSystemName  =  "SystemB"; 

nsURI  =  new  URL ( 

testclasses . CCR. SystemA_l_View_l_A. SystemAlViewlADescriptor ( ) ) . getNameSpaceURI ( ) ) ; 

String  xmlString  =  "<?xml  version=\ " 1 . 0\ " ?>" 

+  "<SystemA_l_View_l_A>" 

+  "  <NameOfOb ject>"  +  nameOfObject  +  "</NameOfOb ject>" 

+  "  <PST> " 

+  "  <Year>1999</Year>" 

+  "  <Month>01</Month>" 

+  "  <Day>31</Day>" 

+  "  <Hour>01</Hour>" 

+  "  <Minute>59</Minute>" 

+  "  <Second>0 . 0</Second>" 

+  "  </PST> " 

+  "  <String_l_part_l>  part  1</String_l_part_l>" 

+  "  <String_l_part_2>  part  2</String_l_part_2>" 

+  "</SystemA_l_View_l_A>" 

ByteArrayOutputStream  out  =  new  ByteArrayOutputStream (5000)  ; 

Writer  w  =  new  OutputStreamWriter (out ) ; 
w. write (xmlString)  ; 
w . flush  ( ) ; 

in  =  new  ByteArraylnputStream (  out . toByteArray ( )  ); 


} 

testclasses . CCR . SystemB_l_View_l_B . SystemBlViewlB  unmarshal (InputStream  in) 
throws  UnmarshalException  { 


(new 
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testclasses . CCR . SystemB_l_View_l_B . SystemBlViewlB  result  = 

(test classes. CCR . SystemB_l_View_l_B . SystemBlViewlB) 

CCRInstance . unmarshal (testclasses . CCR. SystemB_l_View_l_B . SystemBlViewlB . class,  in) ; 
return  result; 


/** 

*  Class  to  hold  test  data. 

*/ 

class  ZzzTestData_test_translationDetermination_NO_DESTINATION  { 

FIOM  fiom; 

CCR  targetCCR; 

testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_C  srcFCRInstance; 
testclasses. CCR. SystemC_l_View_l_C . SystemCIViewlC  srcCCRInstance; 

FCRInstance  dstFCRInstance; 

CCRInstance  dstCCRInstance; 

CCR [ ]  destCCR; 

//-  constructor 

ZzzTestData_test_translationDetermination_NO_DESTINATION ( )  throws  Exception  { 
fiom  =  oomiDb . newFIOM ( "FIOM  1"); 
createTestFIOM (f iom) ; 

Translator  trans  =  new  Translator (  fiom  ); 

String  sourceSystemName  =  "SystemC"; 

URL  nsURI  =  new  URL  (  (new 

testclasses . CCR. SystemC_l_View_l_C . SystemClViewlCDescriptor ( ) ) . getNameSpaceURI ( ) ) ; 

String  xmlString  =  "<?xml  version=\ " 1 . 0\ " ?>" 

+  "<SystemC_l_View_l_C>" 

+  "  <Name>SystemC  Name</Name>" 

+  "  <Time>19990102282359</Time>" 

+  "</SystemC_l_View_l_C>" 


ByteArrayOutputStream  out  =  new  ByteArrayOutputStream (5000) ; 
Writer  w  =  new  OutputStreamWriter (out ) ; 
w. write (xmlString)  ; 
w . flush  ( ) ; 


srcCCRInstance 

=  testclasses . CCR. SystemC_l_View_l_C . SystemCIViewlC . unmarshal (new  InputStreamReader ( 
new  ByteArraylnputStream (out . toByteArray ( ) )  )); 


InputStream  in  =  new  ByteArraylnputStream (  out . toByteArray ( )  ); 


330 


TranslatorSourcelnf o  srclnfo 


trans . createSourcelnf o (  sourceSystemName,  nsURI,  in  ); 

String  destSystem  =  "SystemB"; 

destCCR  =  trans . f indDestinations (  srclnfo,  destSystem  ); 

} 

}  //class  ZzzTestData_test_translationDetermination_NO_DESTINATION 


/** 

*  Tests  the  conversion  of  a  XML  document  into  the  destination  FCRInstance  of 

*  the  destination  system  using  the  translation  determination  algorithm. 

*/ 

public  void  test_translationDetermination_l_A ( )  throws  Exception  { 

ZzzTestData_test_translationDetermination_l  testData  = 

ZzzTestData_test_translationDetermination_l () ; 

assertTrue  (  testData . targetCCR. getCCRName (). equals (  "SystemB_l_View_l_B"  ) 

)  ; 


/** 

*  Tests  the  conversion  of  a  XML  document  into  the  destination  FCRInstance  of 

*  the  destination  system  using  the  translation  determination  algorithm. 

*/ 

public  void  test_translationDetermination_l_B ( )  throws  Exception  { 

ZzzTestData_test_translationDetermination_l  testData  = 

ZzzTestData_test_translationDetermination_l () ; 

assertTrue (  testData . srcFCRInstance . getName  ( ) 

testData . srcCCRInstance . getNameOfOb ject ( )  ) 

)  ; 


/** 

*  Tests  the  conversion  of  a  XML  document  into  the  destination  FCRInstance  of 

*  the  destination  system  using  the  translation  determination  algorithm. 

*/ 

public  void  test_translationDetermination_l_C ( )  throws  Exception  { 

ZzzTestData_test_translationDetermination_l  testData  = 

ZzzTestData_test_translationDetermination_l () ; 

testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_B  dstFCRInstance 

=  (testclasses . FCR. Entity_l . ZZ_Entity_l_View_l_B) testData . dstFCRInstance; 

assertTrue (  dstFCRInstance . getName ( ) . equals (testData . srcFCRInstance . getName ( ) ) 

)  ; 


Tests  the  conversion  of  a  XML  document  into  the  destination  CCRInstance  of 
the  destination  system  using  the  translation  determination  algorithm. 


new 


new 

.  equals ( 


new 
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*/ 

public  void  test_translationDetermination_l_D ( )  throws  Exception  { 

ZzzTestData_test_translationDetermination_l  testData  =  new 

ZzzTestData_test_translationDetermination_l () ; 

test classes. CCR. SystemB_l_View_l_B . SystemBlViewlB  dstCCRInstance 

=  (testclasses . CCR. SystemB_l_View_l_B . SystemBlViewlB)  testData . dstCCRInstance; 

assertTrue (  dstCCRInstance . getBigName (). equals (  "SystemB:"  + 

testData . srcFCRInstance . getName ( )  ) 

)  ; 


/** 

*  Tests  the  conversion  of  a  XML  document  into  the  destination  FCRInstance  of 

*  the  destination  system  using  the  translation  determination  algorithm. 

*/ 

public  void  test_translationDetermination_l_E ( )  throws  Exception  { 

ZzzTestData_test_translationDetermination_l  testData  =  new 

ZzzTestData_test_translationDetermination_l () ; 

assertTrue (  testData . destCCR. length==l  ); 


/** 

*  Tests  a  no  suitable  destination  case,  source  system  is  SystemC. 

*/ 

public  void  test_translationDetermination_NO_DEST_l ( )  throws  Exception  { 
ZzzTestData_test_translationDetermination_NO_DESTINATION  testData 
=  new  ZzzTestData_test_translationDetermination_NO_DESTINATION  (); 
assertEquals (  0,  testData . destCCR. length  ); 


/** 

*  Tests  that  the  code  skeleton  generated  by  the  generator  is  valid. 

*/ 

public  void  test_toCCRInstance ( )  throws  Exception  { 

FIOM  fiom  =  oomiDb . newFIOM ( "New  FiOm"); 

Translator  trans  =  new  Translator (  fiom  ); 

String  sourceSystemName  =  "TheSource"; 

URL  nsURI  =  new  URL (  "http://testing.123.com/"  ); 

fiom. addTranslation (  testclasses. Item. class . getName ( ) , 

testclasses. Invoice .class . getName ( ) , 

testclasses_Item _ testclasses_Invoice . class . getName ( )  ) ; 

CCR  ccr  =  fiom. newFE ("FE") .newChild( "Child") 

. createRootFEV ( "root  FEV") . createFCR ( " f cr " ) 

.newCCR(  sourceSystemName,  "CCR",  nsURI  ); 
ccr . set JavaClassName (  testclasses . Invoice . class . getName ( )  ); 
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ccr . getFCR ( ) . set JavaClassName (  testclasses . Item. class . getName ( )  ) ; 


String  xmlString  =  "<?xml  version=\ " 1 . 0\ " ?>"  + 

"<item  Id=\"0.9.3\"  InStock=\ "true\ "  Category=\ "Open  Source  ProjectV 
xmlns=\ "http : //castor . exolab . org/Test/Invoice\ "><Quantity>l</Quantity><Price>100 . 00</Price></ i 
t  em> " ; 


ByteArrayOutputStream  out  =  new  ByteArrayOutputStream (5000) ; 

Writer  w  =  new  OutputStreamWriter (out ) ; 
w. write (xmlString)  ; 
w . flush  ( ) ; 

Item  item  =  Item. unmarshal (new  InputStreamReader (  new 

ByteArraylnputStream (out . toByteArray ( ) )  ) )  ; 

InputStream  in  =  new  ByteArraylnputStream (  out . toByteArray ( )  ); 

Invoice  ccrlnstance  =  ( Invoice) trans . toCCRInstance (  ccr,  item  ); 

assertTrue  (ccrlnstance ! =null) ; 

//assertEquals (  "category:  "  +  category  ,  item. getCategory ( )  ); 


/** 

*  Tests  the  one-step  convenience  method:  translate (). 

*/ 

public  void  test_translate_l ( )  throws  Exception  { 

ZzzTestData_test_translate_l  testData  =  new  ZzzTestData_test_translate_l ( ) ; 

Translator  trans  =  new  Translator (testData . fiom)  ; 

ByteArrayOutputStream  out  =  new  ByteArrayOutputStream (5000) ; 
trans . translate (  testData . sourceSystemName,  testData . nsURI ,  testData. in, 
testData . destinationSystemName, 
out  )  ; 

InputStream  in  =  new  ByteArraylnputStream (out . toByteArray ()) ; 

testclasses . CCR. SystemB_l_View_l_B . SystemBlViewlB  destlnstance  =  testData . unmarshal (in) ; 
assertEquals (  destlnstance . getBigName ( ) , 

"SystemB:"  +  testData . nameOfObject  ); 


}  //public  class  ZzzTest_Translator  extends  TestCase 


//%%  begin  import 
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//  —  Enter  your  additional  imports  here. 

//%%  end  import 

class  testclasses_Item _ testclasses_Customer  extends 

mil . navy . nps . cs . oomi . fiom. Abstract Tran si at ion  { 

//%%  begin  fields 

//  —  Enter  your  custom  fields  here. 

//%%  end  fields 

protected  testclasses_Item _ testclasses_Customer  (  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

init (  testclasses . Item. class,  testclasses . Customer . class  ); 

//%%  end  method_body 

} 


public  java . lang . String  ccrToFcr_category  (  java . lang . String  phone  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 
return  "category:  "  +  phone; 

//%%  end  method_body 

} 


public  java . lang . String  f crToCcr_phone  (  java . lang . String  category  )  { 
//%%  begin  method_body  —  Enter  method  body  below: 
return  "phone:  "  +  category; 

//%%  end  method_body 

} 


public  mil . navy . nps . cs . oomi . fiom. CCRInstance  toCCR  (  mil . navy . nps . cs . oomi . fiom. FCRInstance 
fcrlnstance  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 
testclasses . Item  obj  =  (testclasses . Item)  fcrlnstance; 
testclasses . Customer  result  =  new  testclasses . Customer () ; 

result . setPhone (f crToCcr_phone (obj . getCategory ( ) ) )  ; 

return  result; 

//%%  end  method_body 


public  mil . navy . nps . cs . oomi . fiom. FCRInstance  toFCR  (  mil . navy . nps . cs . oomi . fiom. CCRInstance 
ccrlnstance  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 
testclasses . Customer  obj  =  (testclasses . Customer )  ccrlnstance; 
testclasses . Item  result  =  new  testclasses . Item () ; 
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result . setCategory (ccrToFcr_category (ob j . getPhone ( ) ) ) ; 

return  result; 

//%%  end  method_body 

} 

//%%  begin  methods 

//  —  Enter  your  custom  methods  here. 

//%%  end  methods 


//%%  begin  import 

//  —  Enter  your  additional  imports  here. 

//%%  end  import 

class  testclasses_Item _ testclasses_Invoice  extends 

mil . navy . nps . cs . oomi . fiom. Abstract Tran si at ion  { 

//%%  begin  fields 

//  —  Enter  your  custom  fields  here. 

//%%  end  fields 

protected  testclasses_Item _ testclasses_Invoice  (  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 

init (  testclasses . Item. class,  testclasses . Invoice . class  ); 

//%%  end  method_body 

} 

public  java . lang . String  ccrToFcr_category  (  java . lang . String  carrier  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 
return  "category:  "  +  carrier; 

//%%  end  method_body 

} 

public  java . lang . String  f crToCcr_shippingMethod_carrier  (  java . lang . String  category  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 
return  "carrier:  "  +  category; 

//%%  end  method_body 

} 

public  mil . navy . nps . cs . oomi . fiom. CCRInstance  toCCR  (  mil . navy . nps . cs . oomi . fiom. FCRInstance 
fcrlnstance  )  { 
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//%%  begin  method_body  —  Enter  method  body  below: 
testclasses . Item  obj  =  (testclasses . Item)  fcrlnstance; 
testclasses . Invoice  result  =  new  testclasses . Invoice () ; 

result . setShippingMethod (new  ShippingMethod ( ) ) ; 

result . getShippingMethod ( ) . setCarrier (fcrToCcr_shippingMethod_carrier (obj . getCategory ( ) ) ) ; 

return  result; 

//%%  end  method_body 


public  mil . navy . nps . cs . oomi . fiom. FCRInstance  toFCR  (  mil . navy . nps . cs . oomi . fiom. CCRInstance 
ccrlnstance  )  { 

//%%  begin  method_body  —  Enter  method  body  below: 
testclasses . Invoice  obj  =  (testclasses . Invoice)  ccrlnstance; 
testclasses . Item  result  =  new  testclasses . Item () ; 


result . setCategory (ccrToFcr_category (obj . getShippingMethod ( ) . getCarrier ( ) ) ) ; 

return  result; 

//%%  end  method_body 


//%%  begin  methods 

//  —  Enter  your  custom  methods  here. 
//%%  end  methods 
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